OracleBFileとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

OracleBFile クラス

Oracle の BFILE データ型で動作する、マネージオブジェクト OracleBFile を表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 OracleBFile
    Inherits Stream
    Implements ICloneable, INullable, IDisposable

Visual Basic (使用法)

Dim instance As OracleBFile

public sealed class OracleBFile : Stream, ICloneable,
 INullable, IDisposable

C++

public ref class OracleBFile sealed : public
 Stream, ICloneable, INullable, IDisposable

public final class OracleBFile extends Stream
 implements ICloneable, INullable, 
    IDisposable

JScript

public final class OracleBFile extends
 Stream implements ICloneable, INullable, 
    IDisposable

解説

Oracle の BFILE データ型は、最大 4 ギガバイトのバイナリデータへの参照を格納する、Oracle の LOB データ型です。Oracle の BFILE は、データが、サーバーにではなくオペレーティングシステムの物理ファイルに格納されるという点で、LOB データ型とは異なります。BFILE データ型が提供しているのは、データの読み取り専用アクセスです。そのため、Stream クラスから継承された書き込み用のメソッドはサポートしていません。

BFILE データ型が LOB データ型と異なる点として、他に次に挙げたものがあります。

非構造化データを格納する。
サーバー側チャンク処理をサポートしている。
参照コピーのセマンティクスを使用する。たとえば、BFILE でコピー操作を実行すると、BFILE ロケータ (ファイルへの参照) だけがコピーされます。ファイル内のデータは、コピーされません。

BFILE データ型は、サイズが大きいためにデータベースへの格納には向かない LOB の参照に使用します。BFILE データ型を使用した場合、LOB データ型を使用した場合と比べて、クライアント、サーバー、および通信のオーバーヘッドが発生します。サイズの小さいデータだけを取得する必要がある場合は、BFILE にアクセスした方が効率的です。オブジェクト全体を取得する必要がある場合は、データベースに常駐する LOB にアクセスした方が効率的です。

NULL ではない各 OracleBFile オブジェクトには、基になる物理ファイルの位置を定義する、次の 2 つのエンティティが関連付けられます。

データベースでファイルシステムのディレクトリを表す別名である、Oracle の DIRECTORY オブジェクト。
DIRECTORY オブジェクトが表すディレクトリに配置されている、基になる物理ファイルの名前。

BFILE を作成した後、そのロケータを、ExecuteReader メソッドまたは ExecuteScalar メソッドを使用して、OracleBFile オブジェクトの形式で取得できます。

OracleBFile オブジェクトを取得するには、GetOracleBFile メソッドを呼び出します。

OracleBFile オブジェクトに関連付けられている物理ファイルは、そのファイルにアクセスするまで存在しなくてもかまいません。アプリケーションでは、存在しないファイルに OracleBFile をバインドしてから、指定した位置に物理ファイルを作成し、Read を呼び出すことができます。

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

Oracle テーブル内で BFILE を作成し、これを OracleBFile オブジェクトの形式で取得する C# のコード例を次に示します。ここでは、OracleDataReader オブジェクト、および OracleBFile の Seek メソッドと Read メソッドを使用する例を示します。

private void GetOracleBFile(string
 connectionString)
{
    //Create and open the connection.
    using (OracleConnection connection = new
 OracleConnection(connectionString))
    {
        connection.Open();

        //Create and execute the commands.
        OracleCommand command = connection.CreateCommand();
        command.CommandText = "CREATE OR REPLACE DIRECTORY TestDir AS 'c:\\bfiles'";
        command.ExecuteNonQuery();
        command.CommandText = "CREATE TABLE TestTable(col1 number, col2 BFILE)";
        command.ExecuteNonQuery();
        command.CommandText = "INSERT INTO TestTable VALUES ('2', BFILENAME('TESTDIR',
 'File.jpg'))";
        command.ExecuteNonQuery();
        command.CommandText = "SELECT * FROM TestTable";

        //Read the BFile data.
        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);
                }
            }
        }
    }
    return;
}

Oracle の BFILE の作成と使用に関する詳細については、Oracle のドキュメントの該当するトピックを参照してください。

メモ
BFILE データ型は読み取り専用であるため、System.IO.Stream クラスから継承される BeginWrite メソッド、EndWrite メソッド、および WriteByte メソッドは、サポートされません。

継承階層

System.Object
   System.MarshalByRefObject
     System.IO.Stream
      System.Data.OracleClient.OracleBFile

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

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

参照

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

OracleBFile フィールド

パブリックフィールドパブリックフィールド

	名前	説明
	Null	物理ファイルにバインドされていない、null の OracleBFile オブジェクトを表します。

参照

OracleBFile プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	CanRead	オーバーライドされます。 BFILE ストリームを読み取ることができるかどうかを示す値を取得します。
	CanSeek	オーバーライドされます。前方シークおよび後方シーク操作を実行できるかどうかを示す値を取得します。
	CanTimeout	現在のストリームがタイムアウトできるかどうかを決定する値を取得します。 ( Stream から継承されます。)
	CanWrite	オーバーライドされます。オブジェクトが書き込みをサポートしているかどうかを示す値を取得します。
	Connection	この OracleBFile のインスタンスで使用される OracleConnection を取得します。
	DirectoryName	OracleBFile オブジェクトが関連付けられている DIRECTORY オブジェクトの名前を取得します。
	FileExists	BFILE データを格納している物理ファイルがオペレーティングシステム上に存在するかどうかを示す値を取得します。
	FileName	パス名なしの BFILE の名前を取得します。
	IsNull	OracleBFile が Null ストリームであるかどうかを示す値を取得します。
	Length	オーバーライドされます。 OracleBFile オブジェクトが関連付けられている物理ファイルの長さ (バイト数) を返す値を取得します。
	Position	オーバーライドされます。 OracleBFile ストリーム内の現在の読み込み位置を取得します。
	ReadTimeout	ストリームがタイムアウト前に読み取りを試行する期間を決定する値を取得または設定します。 ( Stream から継承されます。)
	Value	OracleBFile データを格納している Byte 型の Array を取得します。
	WriteTimeout	ストリームがタイムアウト前に書き込みを試行する期間を決定する値を取得または設定します。 ( Stream から継承されます。)

参照

OracleBFile メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	BeginRead	非同期の読み込み動作を開始します。 ( Stream から継承されます。)
	BeginWrite	非同期の書き込み操作を開始します。 ( Stream から継承されます。)
	Clone	元のオブジェクトと同じ物理ファイルに関連付けられた、この OracleBFile オブジェクトのコピーを作成します。
	Close	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。 ( Stream から継承されます。)
	CopyTo	オーバーロードされます。この OracleBFile のデータをコピー先の OracleLob にコピーします。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。この Stream オブジェクトによって使用されているすべてのリソースを解放します。 ( Stream から継承されます。)
	EndRead	保留中の非同期読み取りが完了するまで待機します。 ( Stream から継承されます。)
	EndWrite	非同期書き込み操作を終了します。 ( Stream から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Flush	オーバーライドされます。現在サポートされていません。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Read	オーバーライドされます。現在の OracleBFile ストリームからバイトシーケンスを読み取り、読み取ったバイト数の分だけストリーム内の位置を進めます。
	ReadByte	ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。 ( Stream から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Seek	オーバーライドされます。現在の OracleBFile ストリームで位置を設定します。
	SetFileName	OracleBFile オブジェクトをオペレーティングシステムの別のファイルにバインドします。
	SetLength	オーバーライドされます。現在サポートされていません。
	Synchronized	指定した Stream オブジェクトをラップするスレッドセーフな (同期された) ラッパーを作成します。 ( Stream から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Write	オーバーライドされます。現在サポートされていません。
	WriteByte	ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。 ( Stream から継承されます。)

プロテクトメソッド

	名前	説明
	CreateWaitHandle	WaitHandle オブジェクトを割り当てます。 ( Stream から継承されます。)
	Dispose	オーバーロードされます。この Stream オブジェクトによって使用されているすべてのリソースを解放します。 ( Stream から継承されます。)
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

OracleBFile メンバ

Oracle の BFILE データ型で動作する、マネージオブジェクト OracleBFile を表します。このクラスは継承できません。

OracleBFile データ型で公開されるメンバを以下の表に示します。

パブリックフィールド

	名前	説明
	Null	物理ファイルにバインドされていない、null の OracleBFile オブジェクトを表します。

パブリックプロパティ

	名前	説明
	CanRead	オーバーライドされます。 BFILE ストリームを読み取ることができるかどうかを示す値を取得します。
	CanSeek	オーバーライドされます。前方シークおよび後方シーク操作を実行できるかどうかを示す値を取得します。
	CanTimeout	現在のストリームがタイムアウトできるかどうかを決定する値を取得します。(Stream から継承されます。)
	CanWrite	オーバーライドされます。オブジェクトが書き込みをサポートしているかどうかを示す値を取得します。
	Connection	この OracleBFile のインスタンスで使用される OracleConnection を取得します。
	DirectoryName	OracleBFile オブジェクトが関連付けられている DIRECTORY オブジェクトの名前を取得します。
	FileExists	BFILE データを格納している物理ファイルがオペレーティングシステム上に存在するかどうかを示す値を取得します。
	FileName	パス名なしの BFILE の名前を取得します。
	IsNull	OracleBFile が Null ストリームであるかどうかを示す値を取得します。
	Length	オーバーライドされます。 OracleBFile オブジェクトが関連付けられている物理ファイルの長さ (バイト数) を返す値を取得します。
	Position	オーバーライドされます。 OracleBFile ストリーム内の現在の読み込み位置を取得します。
	ReadTimeout	ストリームがタイムアウト前に読み取りを試行する期間を決定する値を取得または設定します。 (Stream から継承されます。)
	Value	OracleBFile データを格納している Byte 型の Array を取得します。
	WriteTimeout	ストリームがタイムアウト前に書き込みを試行する期間を決定する値を取得または設定します。 (Stream から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	BeginRead	非同期の読み込み動作を開始します。 (Stream から継承されます。)
	BeginWrite	非同期の書き込み操作を開始します。 (Stream から継承されます。)
	Clone	元のオブジェクトと同じ物理ファイルに関連付けられた、この OracleBFile オブジェクトのコピーを作成します。
	Close	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。 (Stream から継承されます。)
	CopyTo	オーバーロードされます。この OracleBFile のデータをコピー先の OracleLob にコピーします。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。この Stream オブジェクトによって使用されているすべてのリソースを解放します。 (Stream から継承されます。)
	EndRead	保留中の非同期読み取りが完了するまで待機します。 (Stream から継承されます。)
	EndWrite	非同期書き込み操作を終了します。 (Stream から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Flush	オーバーライドされます。現在サポートされていません。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Read	オーバーライドされます。現在の OracleBFile ストリームからバイトシーケンスを読み取り、読み取ったバイト数の分だけストリーム内の位置を進めます。
	ReadByte	ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。 (Stream から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Seek	オーバーライドされます。現在の OracleBFile ストリームで位置を設定します。
	SetFileName	OracleBFile オブジェクトをオペレーティングシステムの別のファイルにバインドします。
	SetLength	オーバーライドされます。現在サポートされていません。
	Synchronized	指定した Stream オブジェクトをラップするスレッドセーフな (同期された) ラッパーを作成します。 (Stream から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Write	オーバーライドされます。現在サポートされていません。
	WriteByte	ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。 (Stream から継承されます。)

プロテクトメソッド

	名前	説明
	CreateWaitHandle	WaitHandle オブジェクトを割り当てます。 (Stream から継承されます。)
	Dispose	オーバーロードされます。この Stream オブジェクトによって使用されているすべてのリソースを解放します。 (Stream から継承されます。)
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

OracleBFileとは？わかりやすく解説

OracleBFile クラス

OracleBFile フィールド

関連項目

OracleBFile プロパティ

関連項目

OracleBFile メソッド

関連項目

OracleBFile メンバ

関連項目

「OracleBFile」の関連用語


	© 2025 Microsoft.All rights reserved.

OracleBFileとは？ わかりやすく解説

OracleBFile クラス

OracleBFile フィールド

関連項目

OracleBFile プロパティ

関連項目

OracleBFile メソッド

関連項目

OracleBFile メンバ

関連項目

急上昇のことば

「OracleBFile」の関連用語

OracleBFileとは？わかりやすく解説