IDataRecord.GetBytes メソッド

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

Function GetBytes( _
   ByVal i As Integer, _   ByVal fieldOffset As Long, _   ByVal buffer() As Byte, _   ByVal bufferoffset As Integer, _   ByVal length As Integer _) As Long
[C#]
long GetBytes(
   inti,longfieldOffset,byte[] buffer,intbufferoffset,intlength);
[C++]
__int64 GetBytes(
   inti,__int64fieldOffset,unsigned charbuffer __gc[],intbufferoffset,intlength);
[JScript]
function GetBytes(
   i : int,fieldOffset : long,buffer : Byte[],bufferoffset : int,length : int) : long;

パラメータ

• i
  列の 0 から始まる序数。
• fieldOffset
  読み取り操作を開始するフィールド内のインデックス。
• buffer
  バイト ストリームの読み込み先のバッファ。
• bufferoffset
  読み込みを開始する buffer のインデックス。
• length
  読み込むバイト数。

戻り値

実際に読み込んだバイトの数。

例外

解説

GetBytes がフィールド内の使用できるバイト数を返します。ほとんどの場合、これは正確なフィールド長です。ただし、フィールドからバイトを取得するために GetBytes が既に使用されている場合、返される数値はそのフィールドの正確な長さよりも小さいことがあります。

null 参照 (Visual Basic では Nothing) のバッファを渡すと、 GetBytes が行の長さをバイト数で返します。

変換は実行されません。したがって取得されたデータは既にバイト配列である必要があります。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

IDataRecord インターフェイス | IDataRecord メンバ | System.Data 名前空間