SqlCeResultSet.GetBytes Method

從指定欄位的指定位置開始，將某一段位元組複製到緩衝區。

命名空間: 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

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

public long GetBytes (
    int ordinal, 
    long dataIndex, 
    byte[] buffer, 
    int bufferIndex, 
    int length
)

public override function GetBytes (
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

參數

• ordinal
  要從中擷取資料之資料行的序數位置。

• dataIndex
  要從中開始複製資料之欄位中的位移 (Offset) (以位元組為單位)。

• buffer
  要將資料複製到其中的目的緩衝區。

• bufferIndex
  緩衝區中開始複製的位移。

• length
  要複製的最大位元組數目。

傳回值

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

備註

這個函式會傳回實際複製的位元組數目，如果已到達欄位尾端，則此數目可能會小於所要求的長度。

如果您傳入 null 緩衝區，則 GetBytes 會傳回欄位的長度 (以位元組為單位)。

如果以 SequentialAccess 的命令行為執行此命令，則呼叫 GetBytes 必須指定循序增加的讀取數，否則會擲回例外狀況。

GetBytes 只能對基礎類型為 binary 或 varbinary 的資料行進行呼叫，或者是以可轉換成位元組陣列之物件所建構的資料行進行呼叫。

如果指定的序數位置沒有任何欄位，就會擲回例外狀況。

執行緒安全性

任何公用靜態 (共用 在 Microsoft Visual Basic) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
版本資訊
.NET Framework 及 NET Compact Framework
支援於 3.5
.NET Framework
支援於 3.0
.NET Compact Framework 及 .Net Framework
支援於 2.0

另請參閱

參考

SqlCeResultSet Class
SqlCeResultSet Members
System.Data.SqlServerCe Namespace