共用方式為


SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) 方法

定義

取得資料行的值,其由該序數指定為 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

資料行以零為起始的序數。

fieldOffset
Int64

要開始擷取位元組之欄位值的位移。

buffer
Byte[]

要複製位元組到其中的目標緩衝區。

bufferOffset
Int32

要開始複製位元組至其中之緩衝區的位移。

length
Int32

要複製到緩衝區的位元組數目。

傳回

已複製的位元組數目。

實作

例外狀況

ordinal 小於 0 或大於資料行數目 (亦即 FieldCount)。

ordinal 指定的資料行為 null。

類型不符。

備註

這個方法可讓您在單一呼叫或區塊中取得二進位值。 以區塊取得值對於大型值或未知大小的值很有用。

若要在數個區塊中取得值,請配置區塊大小的位元組陣列,並重複呼叫 GetBytes ,並據以在每個呼叫中調整 fieldOffset 參數。

適用於