GetBytes メソッド

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

構文

Visual Basic

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

C#

public override long GetBytes(
   int ordinal,
   long dataIndex,
   byte[] buffer,
   int bufferIndex,
   int length
);

パラメータ

ordinal 値の取得元のカラムを示す順序数。番号は 0 から始まります。
dataIndex バイトの読み込み元のカラム値内のインデックス。
buffer データを格納する配列。
bufferIndex データのコピーを開始する配列内のインデックス。
length 指定されたバッファにコピーするデータの最大長。

戻り値

読み込まれたバイト数。

備考

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

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

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