IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

從指定的緩衝區位移開始，將來自指定資料行位移的字元資料流讀取到緩衝區以做為陣列。

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);

public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);

abstract member GetChars : int * int64 * char[] * int * int -> int64

Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

參數

i

Int32

以零為基底的資料行序數。

fieldoffset

Int64

要開始讀取作業之資料列中的索引。

buffer

Char[]

要將位元組資料流讀取到其中的緩衝區。

bufferoffset

Int32

要開始讀取作業的 buffer 索引。

length

Int32

要讀取的位元組數。

傳回

Int64

讀取的實際字元數目。

例外狀況

IndexOutOfRangeException

傳遞的索引超出 0 到 FieldCount 的範圍。

備註

GetChars 會傳回欄位中可用的字元數。 這通常是欄位的確切長度。 不過，如果 GetChars 已經用來從欄位取得字元，傳回的數位可能小於字段的確切長度。

如果您傳遞的緩衝區為 null， GetChars 則會以字元傳回字段的長度。

不會進行轉換；因此擷取的資料必須已經是字元陣列。