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
參數
- ordinal
- Int32
資料行以零為起始的序數。
- fieldOffset
- Int64
要開始擷取位元組之欄位值的位移。
- buffer
- Byte[]
要複製位元組到其中的目標緩衝區。
- bufferOffset
- Int32
要開始複製位元組至其中之緩衝區的位移。
- length
- Int32
要複製到緩衝區的位元組數目。
傳回
已複製的位元組數目。
實作
例外狀況
ordinal
小於 0 或大於資料行數目 (亦即 FieldCount)。
ordinal
指定的資料行為 null。
類型不符。
備註
這個方法可讓您在單一呼叫或區塊中取得二進位值。 以區塊取得值對於大型值或未知大小的值很有用。
若要在數個區塊中取得值,請配置區塊大小的位元組陣列,並重複呼叫 GetBytes ,並據以在每個呼叫中調整 fieldOffset
參數。