Freigeben über


OracleBFile.Seek-Methode

Legt die Position im aktuellen OracleBFile-Stream fest.

Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)

Syntax

'Declaration
Public Overrides Function Seek ( _
    offset As Long, _
    origin As SeekOrigin _
) As Long
'Usage
Dim instance As OracleBFile
Dim offset As Long
Dim origin As SeekOrigin
Dim returnValue As Long

returnValue = instance.Seek(offset, origin)
public override long Seek (
    long offset,
    SeekOrigin origin
)
public:
virtual long long Seek (
    long long offset, 
    SeekOrigin origin
) override
public long Seek (
    long offset, 
    SeekOrigin origin
)
public override function Seek (
    offset : long, 
    origin : SeekOrigin
) : long

Parameter

  • offset
    Ein Byteoffset relativ zum Ursprung. Wenn offset negativ ist, liegt die die neue Position um die durch offset angegebene Anzahl von Bytes vor der durch origin angegebenen Position. Wenn offset 0 (null) ist, ist die neue Position die durch origin angegebene Position. Wenn offset positiv ist, liegt die neue Position um die durch offset angegebene Anzahl an Bytes hinter der durch origin angegebenen Position.
  • origin
    Ein Wert vom Typ System.IO.SeekOrigin, der den Bezugspunkt angibt, von dem aus die neue Position ermittelt wird.

Rückgabewert

Die neue Position innerhalb des aktuellen Streams.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

Es wurde versucht, eine Position mit einem negativen Wert oder mit einem Wert festzulegen, der größer als die Länge des Streams ist.

ObjectDisposedException

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen oder freigegeben wurde.

Hinweise

Wenn offset negativ ist, muss die neue Position um die durch offset angegebene Anzahl von Bytes vor der durch origin angegebenen Position liegen. Wenn offset 0 (null) ist, muss die neue Position die durch origin angegebene Position sein. Wenn offset positiv ist, muss die neue Position um die durch offset angegebene Anzahl von Bytes hinter der durch origin angegebenen Position liegen.

Suchvorgänge an Positionen über die Länge des Streams hinaus werden nicht unterstützt.

Beim Versuch, auf eine geschlossene OracleBFile mithilfe der Read-Methode oder der Seek-Methode zuzugreifen, wird automatisch ein OracleBFile-Stream erneut geöffnet.

Im folgenden C#-Beispiel wird von einer Oracle-Tabelle mit diesem Schema ausgegangen:

(col1 number, col2 BFILE)

Das Beispiel veranschaulicht die Verwendung der Read-Methode und der Seek-Methode zum Zugreifen auf ein OracleBFile-Objekt.

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);
        }
    }
}

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OracleBFile-Klasse
OracleBFile-Member
System.Data.OracleClient-Namespace