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

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

序数で指定された列の値を Byte オブジェクトの配列として取得します。

public:
 virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);

public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);

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

Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

列の 0 から始まる序数。

フィールド値内のバイトの取得開始位置となるオフセット。

バイトのコピー先のバッファー。

バッファー内のバイトのコピー開始位置を示すオフセット。

バッファーにコピーするバイト数。

Int64

コピーされたバイト数。

ordinal が 0 未満か、列の数を超えています (つまり、FieldCount)。

ordinal で指定された列が NULL です。

型が一致しません。

このメソッドを使用すると、1 回の呼び出しまたはチャンクでバイナリ値を取得できます。値をチャンク単位で取得すると、大きな値や不明なサイズの値に役立ちます。

値を複数のチャンクで取得するには、チャンクサイズのバイト配列を割り当て、呼び出 GetBytes しを繰り返し行い、各呼び出しでパラメーターを調整 fieldOffset します。