OracleBFile.Read メソッド

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

OracleBFile.Read メソッド

現在の OracleBFile ストリームからバイト シーケンスを読み取り、読み取ったバイト数の分だけストリーム内の位置を進めます。

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

Visual Basic (宣言)

Public Overrides Function
 Read ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As OracleBFile
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.Read(buffer, offset, count)

C#

public override int Read (
    byte[] buffer,
    int offset,
    int count
)

C++

public:
virtual int Read (
    array<unsigned char>^ buffer, 
    int offset, 
    int count
) override

J#

public int Read (
    byte[] buffer, 
    int offset, 
    int count
)

JScript

public override function Read (
    buffer : byte[], 
    offset : int, 
    count : int
) : int

パラメータ

buffer

バイト配列。このメソッドが戻るとき、指定したバイト配列の offset から (offset + count) までの値が、現在のソースから読み取られたバイトに置き換えられて含まれます。

offset

現在のストリームから読み取ったデータの格納を開始する位置を示す buffer内のバイト オフセット。インデックス番号は 0 から始まります。

count

現在のストリームから読み取る最大バイト数。

戻り値
バッファに読み取られた合計バイト数。要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ファイルの末尾に到達した場合は、ゼロになることがあります。

例外

例外の種類	条件
ArgumentException	offset と count の合計値が、バッファ長を超えています。
ArgumentNullException	buffer が null 参照 (Visual Basic の場合は Nothing) です。
ArgumentOutOfRangeException	offset または count が負の値です。
InvalidOperationException	BFILE に関連付けられている接続が閉じています。
IOException	I/O エラーが発生しました。
ObjectDisposedException	ストリームが閉じられたか破棄された後で、メソッドが呼び出されました。

解説

Read メソッドは、現在のストリームから最大で count で指定したバイト数だけ読み込み、読み込んだバイトを buffer 内の offset で始まる位置に格納します。ストリームの現在位置が、読み込んだバイト数だけ進みます。ただし、例外が発生した場合は、ストリーム内の現在位置はそのまま変わりません。Read は、読み込んだバイト数を返します。現在の位置がストリームの末尾である場合だけ、0 の値が返されます。読み取るデータがない場合、Read は、最低 1 バイトのデータを読み取ることができるまでブロックされます。Read は、ファイルの末尾に到達した場合にだけ 0 を返します。ストリームの末尾に到達していない場合でも、Read は、要求されたバイト数未満のデータを返すことができます。

Read メソッドまたは Seek メソッドを使用して、閉じている OracleBFile にアクセスしようとすると、自動的に OracleBFile ストリームが再度開かれます。

次の C# の例では、Oracle テーブルにおいてこの方法を用いることを想定しています。

(col1 number, col2 BFILE)

Read メソッドと Seek メソッドを使用して OracleBFile オブジェクトにアクセスする例を次に示します。

byte[] buffer = new byte[100];
OracleDataReader dataReader = command.ExecuteReader();
using (dataReader) {
    if (dataReader.Read()) {
            OracleBFile BFile = dataReader.GetOracleBFile(1);
        using (BFile) {
            BFile.Seek(0, SeekOrigin.Begin);
            BFile.Read(buffer, 0, 100);
        }
    }
}

プラットフォーム

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

参照

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