Stream.Seek-Methode

Artikel
08/20/2007

Legt beim Überschreiben in einer abgeleiteten Klasse die Position im aktuellen Stream fest.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

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

returnValue = instance.Seek(offset, origin)

public abstract long Seek (
    long offset,
    SeekOrigin origin
)

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

public abstract long Seek (
    long offset, 
    SeekOrigin origin
)

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

Parameter

offset
Ein Byteoffset relativ zum origin-Parameter.

origin
Ein Wert vom Typ 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
IOException	Ein E/A-Fehler tritt auf.
NotSupportedException	Der Stream unterstützt keine Suchvorgänge. Dies ist beispielsweise der Fall, wenn der Stream aus einer Pipe- oder Konsolenausgabe erstellt wird.
ObjectDisposedException	Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Gewusst wie: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen aus einer Textdatei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei.

Verwenden Sie die CanSeek-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Suchvorgänge unterstützt.

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 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.

Die vom Stream abgeleiteten Klassen, die Suchvorgänge unterstützen, müssen diese Methode überschreiben, um die oben beschriebenen Funktionen bereitzustellen.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Stream-Klasse
Stream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über