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

定義

名前空間:

Microsoft.Data.SqlClient.Server

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

序数で指定された列の値を 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

パラメーター

ordinal

Int32

列の 0 から始まる序数。

fieldOffset

Int64

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

buffer

Byte[]

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

bufferOffset

Int32

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

length

Int32

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

戻り値

Int64

コピーされたバイト数。

実装

GetBytes(Int32, Int64, Byte[], Int32, Int32)

例外

IndexOutOfRangeException

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

SqlNullValueException

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

InvalidCastException

型が一致しません。

注釈

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

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