日本語PDF

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値を確認してください。