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 -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
パラメーター
- i
- Int32
0 から始まる列序数。
- dataIndex
- Int64
読み取り操作を開始する行内のインデックス。
- buffer
- Char[]
データのコピー先のバッファー。
- bufferIndex
- Int32
書き込み操作を開始する buffer
内のインデックス。
- length
- Int32
読み取る文字の数。
戻り値
実際に読み取られた文字数。
実装
注釈
GetChars は、フィールドで使用可能な文字数を返します。 ほとんどの場合、これはフィールドの正確な長さです。 ただし、既に GetChars を使用してフィールドから文字を取得している場合、返される文字数はフィールドの正しい長さよりも少なくなる場合があります。 たとえば、 が大きなデータ構造を OdbcDataReader バッファーに読み取る場合などです。 詳細については、 の設定CommandBehaviorをSequentialAccess
参照してください。
null 値のバッファーを渡すと、 GetChars フィールドの長さが文字で返されます。
変換は、ODBC ドライバーの基になる機能に基づいて実行されます。 変換がサポートされていない場合、メソッド呼び出しは失敗します。
注意
の値が配列の bufferIndex
外側にある場合、例外はスローされません。 データは読み取られず、メソッドは 0 を返します。
適用対象
こちらもご覧ください
.NET