OracleDataReader.GetBytes メソッド

.NET Framework クラス ライブラリ リファレンス

OracleDataReader.GetBytes メソッド

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

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetBytes ( _
    i As Integer, _
    fieldOffset As Long, _
    buffer2 As Byte(), _
    bufferoffset As Integer, _
    length As Integer _
) As Long

Visual Basic (使用法)

Dim instance As OracleDataReader
Dim i As Integer
Dim fieldOffset As Long
Dim buffer2 As Byte()
Dim bufferoffset As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetBytes(i, fieldOffset, buffer2, bufferoffset, length)

C#

public override long GetBytes (
    int i,
    long fieldOffset,
    byte[] buffer2,
    int bufferoffset,
    int length
)

C++

public:
virtual long long GetBytes (
    int i, 
    long long fieldOffset, 
    array<unsigned char>^ buffer2, 
    int bufferoffset, 
    int length
) override

J#

public long GetBytes (
    int i, 
    long fieldOffset, 
    byte[] buffer2, 
    int bufferoffset, 
    int length
)

JScript

public override function GetBytes (
    i : int, 
    fieldOffset : long, 
    buffer2 : byte[], 
    bufferoffset : int, 
    length : int
) : long

パラメータ

i

列の 0 から始まる序数。

fieldOffset

読み込みを開始するフィールド内のインデックス。

buffer2

バイト ストリームの読み込み先のバッファ。

bufferoffset

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

length

読み込むバイト数。

戻り値
実際に読み込まれたバイト数。

解説

GetBytes は、フィールド内の利用可能なバイト数を返します。ほとんどの場合、これは正確なフィールド長です。ただし、既に GetBytes を使用してフィールドからバイトを取得している場合は、返されるバイト数が、フィールドの実際の長さよりも小さくなることがあります。これは、OracleDataReader が大きいデータ構造体をバッファに読み込んでいるときなどに起こります。詳細については、「CommandBehavior」の SequentialAccess 設定を参照してください。

null 値のバッファを渡すと、GetBytes は、バイト単位のフィールド長を返します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleDataReader クラス
OracleDataReader メンバ
System.Data.OracleClient 名前空間