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

定義

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

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);
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

読み取るバイト数。

戻り値

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

例外

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

注釈

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

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

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

適用対象