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