OdbcDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
從指定的欄位偏移量讀取字元串流，作為陣列從該緩衝區偏移開始。
public:
override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public:
virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[]? buffer, int bufferIndex, int length);public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);override this.GetChars : int * int64 * char[] * int * int -> int64abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long參數
- i
- Int32
零基列序數。
- dataIndex
- Int64
讀取操作開始的列內的索引。
- buffer
- Char[]
用來複製資料的緩衝區。
- bufferIndex
- Int32
在 中 buffer ，寫入操作是要開始的索引。
- length
- Int32
字數的數量。
傳回
實際閱讀的字元數。
實作
備註
GetChars 回傳欄位中可用字元的數量。 大多數時候，這正是田地的精確長度。 然而，若 GetChars 已用於取得欄位的字元，回傳的數字可能小於該欄位的真實長度。 例如，當 將 OdbcDataReader 大型資料結構讀取到緩衝區時，情況可能就會出現。 欲了解更多資訊，請參閱 的SequentialAccess設定。CommandBehavior
如果你通過一個空值的緩衝區，會 GetChars 回傳欄位的長度（以字元表示）。
轉換是根據 ODBC 驅動程式的底層能力執行的。 若不支援轉換，則方法呼叫將失敗。
Note
若值 bufferIndex 不在陣列之外，則不會拋出例外。 不會讀取任何資料，且方法回傳為 0。
