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

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

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);

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

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

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

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

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

要讀取的位元組數。

Int64

讀取的實際字元數目。

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

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

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

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

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1