OdbcDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) メソッド

定義

名前空間:

System.Data.Odbc

アセンブリ:

System.Data.Odbc.dll

パッケージ:

System.Data.Odbc v8.0.0

ソース:

OdbcDataReader.cs

指定したバッファー オフセットを開始位置として、指定した列オフセットからバッファーに、文字のストリームを配列として読み込みます。

public:
 override 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);

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

パラメーター

i

Int32

0 から始まる列序数。

dataIndex

Int64

読み取り操作を開始する行内のインデックス。

buffer

Char[]

データのコピー先のバッファー。

bufferIndex

Int32

書き込み操作を開始する buffer 内のインデックス。

length

Int32

読み取る文字の数。

戻り値

Int64

実際に読み取られた文字数。

注釈

GetChars は、フィールドで使用可能な文字数を返します。 ほとんどの場合、これはフィールドの正確な長さです。 ただし、既に GetChars を使用してフィールドから文字を取得している場合、返される文字数はフィールドの正しい長さよりも少なくなる場合があります。 たとえば、 が大きなデータ構造を OdbcDataReader バッファーに読み取る場合などです。 詳細については、 の設定CommandBehaviorをSequentialAccess参照してください。

null 値のバッファーを渡すと、 GetChars フィールドの長さが文字で返されます。

変換は、ODBC ドライバーの基になる機能に基づいて実行されます。 変換がサポートされていない場合、メソッド呼び出しは失敗します。

注意

の値が配列の bufferIndex 外側にある場合、例外はスローされません。 データは読み取られず、メソッドは 0 を返します。

こちらもご覧ください

• DataAdapter と DataReader