SqlCeDataReader.GetChars 方法
從指定的資料行位移將字元的資料流讀入做為陣列的緩衝區，開始於指定的緩衝區位移。
命名空間： System.Data.SqlServerCe
組件： System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)
語法
'宣告
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetChars ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Char(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'用途
Dim instance As SqlCeDataReader
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)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetChars(
int ordinal,
long dataIndex,
char[] buffer,
int bufferIndex,
int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetChars(
int ordinal,
long long dataIndex,
array<wchar_t>^ buffer,
int bufferIndex,
int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
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
要開始讀取作業的 buffer 索引。
- length
型別：System.Int32
要讀取的字元數。
傳回值
型別：System.Int64
讀取的實際字元數目。
實作
IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)
例外狀況
| 例外狀況 | 條件 |
|---|---|
| InvalidOperationException | 作業無效。SqlCeDataReader 可能位在結果集的最後一個資料列之後。 |
備註
GetChars 會傳回資料欄位中可用字元的數目。在大部分的狀況中，這是資料欄位的確切長度。不過，如果已使用 GetChars 取得資料欄位的字元，則傳回的數目可能會小於資料欄位真正的長度。例如，當 SqlCeDataReader 正在將大型資料結構讀入緩衝區時，可能就是這種狀況。如需詳細資訊，請參閱 CommandBehavior 的 SequentialAccess 設定。
如果傳遞的緩衝區為 nullnull 參考 (在 Visual Basic 中為 Nothing)，則 GetChars 會以字元為單位傳回欄位的長度。
並未執行任何轉換，因此所擷取的資料必須已經是字元陣列。