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