OracleBFile.Seek メソッド

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

OracleBFile.Seek メソッド

現在の OracleBFile ストリームで位置を設定します。

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

Visual Basic (宣言)

Public Overrides Function
 Seek ( _
    offset As Long, _
    origin As SeekOrigin _
) As Long

Visual Basic (使用法)

Dim instance As OracleBFile
Dim offset As Long
Dim origin As SeekOrigin
Dim returnValue As Long

returnValue = instance.Seek(offset, origin)

C#

public override long Seek (
    long offset,
    SeekOrigin origin
)

C++

public:
virtual long long Seek (
    long long offset, 
    SeekOrigin origin
) override

J#

public long Seek (
    long offset, 
    SeekOrigin origin
)

JScript

public override function Seek (
    offset : long, 
    origin : SeekOrigin
) : long

パラメータ

offset

原点からのバイト オフセット。offsetが負の値の場合は、originで指定した位置から offset で指定したバイト数だけさかのぼった位置が新しい位置になります。offset が 0 の場合は、origin で指定した位置が新しい位置になります。offsetが正の値の場合は、originで指定した位置から offset で指定したバイト数だけ進んだ位置が新しい位置になります。

origin

新しい位置を取得するために使用する参照ポイントを示す System.IO.SeekOrigin 型の値。

戻り値
現在のストリーム内の新しい位置。

例外

例外の種類	条件
ArgumentOutOfRangeException	負の値またはストリーム長を超える値に、位置を設定しようとしました。
ObjectDisposedException	ストリームが閉じられたか破棄された後で、メソッドが呼び出されました。

解説

offset が負の値の場合は、origin で指定した位置から offset で指定したバイト数だけさかのぼった位置が新しい位置になります。offset がゼロの場合は、origin で指定した位置が新しい位置になります。offset が正の値の場合は、origin で指定した位置から offset で指定したバイト数だけ進んだ位置が新しい位置になります。

ストリーム長を超えた位置へのシークはサポートされていません。

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 名前空間