GetChars メソッド

指定されたカラム・オフセットから文字のストリームを特定のバッファ・オフセットから始まる配列としてバッファに読み込みます。

構文

Visual Basic

Public Overrides Function GetChars( _
   ByVal ordinal As Integer, _
   ByVal dataIndex As Long, _
   ByVal buffer As Char(), _
   ByVal bufferIndex As Integer, _
   ByVal length As Integer _
) As Long

C#

public override long GetChars(
   int ordinal,
   long dataIndex,
   char[] buffer,
   int bufferIndex,
   int length
);

パラメータ

ordinal 0 から始まるカラムの順序。
dataIndex 読み込みオペレーションを開始するロー内のインデックス。
buffer データのコピー先のバッファ。
bufferIndex 読み込みオペレーションを開始するバッファのインデックス。
length 読み込まれる文字数。

戻り値

実際に読み込まれた文字数。

備考

GetChars は、フィールド内で使用可能な文字数を返します。ほとんどの場合、これは正確なフィールド長です。ただし、GetChars を使用してフィールドから文字がすでに取得されている場合、返される数値が実際の長さより小さくなる可能性があります。これはたとえば、SADataReader がサイズの大きいデータ構造体をバッファに読み込む場合などです。

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

変換は行われないため、取り出されるデータはすでに文字配列である必要があります。

BLOB の処理については、BLOB の処理を参照してください。