IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) メソッド

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

指定した列オフセットから、指定したバッファー オフセットから始まるバイトのストリームを、配列としてバッファーに読み取ります。

public:
 long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferoffset, int length);

public long GetBytes (int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length);

abstract member GetBytes : int * int64 * byte[] * int * int -> int64

Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As Long

パラメーター

i

Int32

0 から始まる列序数。

fieldOffset

Int64

読み取り操作を開始する位置を示すフィールド内のインデックス。

buffer

Byte[]

バイトのストリームを読み込むバッファー。

bufferoffset

Int32

読み取り操作を開始する buffer のインデックス。

length

Int32

読み取るバイト数。

戻り値

Int64

実際に読み取られたバイト数。

例外

IndexOutOfRangeException

渡されたインデックスは 0 から FieldCount の範囲外にあります。

注釈

GetBytes は、フィールドで使用可能なバイト数を返します。 多くの場合、これはフィールドの正確な長さです。 ただし、フィールドからバイトを取得するために既に使用されている場合は、返される数値がフィールドの実際の長さより小さい場合 GetBytes があります。

であるnullGetBytesバッファーを渡すと、行の長さがバイト単位で返されます。

変換は実行されません。したがって、取得されるデータは既にバイト配列である必要があります。