Freigeben über


MemoryStream.Seek-Methode

Legt die Position im aktuellen Stream auf den angegebenen Wert fest.

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

Syntax

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

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

Parameter

  • offset
    Die neue Position innerhalb des Streams. Diese ist relativ zum loc-Parameter und kann positiv oder negativ sein.
  • loc
    Ein Wert vom Typ SeekOrigin, der den Bezugspunkt für die Suche darstellt.

Rückgabewert

Die neue Position im Stream, die durch Kombinieren des anfänglichen Verweispunktes und des Offsets berechnet wird.

Ausnahmen

Ausnahmetyp Bedingung

IOException

Es wurde versucht, eine Suche vor dem Anfang des Streams auszuführen.

ArgumentOutOfRangeException

offset ist größer als MaxValue.

ArgumentException

Ein SeekOrigin ist ungültig.

ObjectDisposedException

Der aktuelle Instanz des Streams ist geschlossen.

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.

Diese Methode überschreibt Seek.

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

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die MemoryStream-Klasse.

' Set the stream position to the beginning of the stream.
memStream.Seek(0, SeekOrigin.Begin)
// Set the position to the beginning of the stream.
memStream.Seek(0, SeekOrigin.Begin);
// Set the stream position to the beginning of the stream.
memStream->Seek( 0, SeekOrigin::Begin );
// Set the position to the beginning of the stream.
memStream.Seek(0, SeekOrigin.Begin);

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

MemoryStream-Klasse
MemoryStream-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