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 で意見交換できます