SqlCeResultSet.GetBytes 方法
從指定欄位的指定位置開始，將某一段位元組複製到緩衝區。
命名空間： System.Data.SqlServerCe
組件： System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)
語法
'宣告
Public Overrides Function GetBytes ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Byte(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'用途
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetBytes(ordinal, _
dataIndex, buffer, bufferIndex, length)
public override long GetBytes(
int ordinal,
long dataIndex,
byte[] buffer,
int bufferIndex,
int length
)
public:
virtual long long GetBytes(
int ordinal,
long long dataIndex,
array<unsigned char>^ buffer,
int bufferIndex,
int length
) override
abstract GetBytes :
ordinal:int *
dataIndex:int64 *
buffer:byte[] *
bufferIndex:int *
length:int -> int64
override GetBytes :
ordinal:int *
dataIndex:int64 *
buffer:byte[] *
bufferIndex:int *
length:int -> int64
public override function GetBytes(
ordinal : int,
dataIndex : long,
buffer : byte[],
bufferIndex : int,
length : int
) : long
參數
- ordinal
型別：System.Int32
要從中擷取資料之資料行的序數位置。
- dataIndex
型別：System.Int64
要從中開始複製資料之欄位中的位移 (Offset) (以位元組為單位)。
- buffer
型別：array<System.Byte[]
要複製資料的目的緩衝區。
- bufferIndex
型別：System.Int32
緩衝區中開始複製的位移。
- length
型別：System.Int32
要複製的最大位元組數目。
傳回值
型別：System.Int64
實際複製到緩衝區的位元組數目。
實作
IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)
備註
這個函式會傳回實際複製的位元組數目，如果已到達欄位尾端，則此數目可能會小於所要求的長度。
如果您傳入 null 緩衝區，則 GetBytes 會傳回欄位的長度 (以位元組為單位)。
如果以 SequentialAccess 的命令行為執行此命令，則呼叫 GetBytes 必須指定循序增加的讀取數，否則會擲回例外狀況。
GetBytes 只能對基礎類型為 binary 或 varbinary 的資料行進行呼叫，或者是以可轉換成位元組陣列之物件所建構的資料行進行呼叫。
如果指定的序數位置沒有任何欄位，就會擲回例外狀況。