GetChars メソッド

指定されたオフセットで始まる、指定された ULDbType.LongVarchar カラムの値のサブセットを、コピー先の System.Char 配列の指定されたオフセットにコピーします。

Visual Basic 構文

Public Overrides Function GetChars(
     ByVal colID As Integer,
    ByVal srcOffset As Long,
    ByVal dst As Char(),
    ByVal dstOffset As Integer,
    ByVal count As Integer
) As Long

C# 構文

public override long GetChars(
     int colID,
    long srcOffset,
    char[] dst,
    int dstOffset,
    int count
)

パラメーター

colID カラムの ID 番号。値は、[0,ULDataReader.FieldCount-1] の範囲内であることが必要です。カーソルの先頭カラムの ID 値は 0 です。
srcOffset カラム値の開始位置。最初の値は 0 です。
dst コピー先の配列。
dstOffset コピー先の配列の開始位置。
count コピーされる文字数。

戻り値

例外

備考

NULL 参照 (Visual Basic の Nothing) である dst バッファーを渡すと、GetChars はフィールドの長さを文字数として返します。

値の srcOffset から srcOffset+count-1 までの位置の文字が、コピー先の配列の dstOffset から dstOffset+count-1 までの位置に、それぞれコピーされます。count の文字数がコピーされる前に、値の末尾が検出された場合は、コピー先の配列の残りは変更されないままになります。

次のいずれかに該当する場合、コード ULSQLCode.SQLE_INVALID_PARAMETER とともに ULException がスローされ、追加先は修正されません。

srcOffset が負である。
dstOffset が負である。
count が負である。
dstOffset +count は dst の長さより長い。

その他のエラーの場合は、それに応じたエラーコードとともに ULException がスローされます。

参照

DocCommentXchange で意見交換できます