GetChars
このメソッドは、列の指定されたオフセット(文字表示)から、最高の場合最大文字数を使用して、指定された文字配列を作成します。
宣言
// C# public override long GetChars(int index, long fieldOffset, char[] buffer, int bufferOffset, int length);
パラメータ
-
index
ゼロベースの列索引
-
fieldOffset
読取り開始対象の列内の索引(文字)
-
buffer
データの読取り先の文字配列
-
bufferOffset
データ読取り開始対象の、バッファ内の索引(文字)
-
length
読取りを行う最大文字数(文字)
戻り値
読取りが終了した文字数
実装
IDataRecord
例外
InvalidOperationException
- 接続またはリーダーがクローズされているか、Read()
が呼び出されていないか、すべての行が読み取られています。
IndexOutOfRangeException
- 列索引が無効です。
InvalidCastException
- この列型のアクセッサ・メソッドが無効か、列値がNULL
です。
備考
このメソッドは、バッファに読み取られた文字数を戻します。メソッドが同じ列に対して前に呼び出されている場合は、文字数は実際のフィールド長より短くなる場合があります。
NULL参照がバッファに渡された場合、文字表示のフィールド長が戻されます。
このメソッドを呼び出す前にIsDBNull
を呼び出して、NULL
値を確認してください。