MemoryStream.Seek(Int64, SeekOrigin) Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: MemoryStream.cs

Quelle:: MemoryStream.cs

Quelle:: MemoryStream.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 override long Seek(long offset, System::IO::SeekOrigin loc);

public override long Seek (long offset, System.IO.SeekOrigin loc);

override this.Seek : int64 * System.IO.SeekOrigin -> int64

Public Overrides Function Seek (offset As Long, loc As SeekOrigin) As Long

Parameter

offset: Int64

Die neue Position innerhalb des Streams. Diese ist relativ zum loc-Parameter und kann positiv oder negativ sein.

loc: SeekOrigin

Ein Wert vom Typ SeekOrigin, der den Bezugspunkt für die Suche darstellt.

Gibt zurück

Int64

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

Ausnahmen

IOException

Es wird versucht, vor Beginn des Streams eine Suche auszuführen.

ArgumentOutOfRangeException

offset ist größer als Int32.MaxValue.

ArgumentException

Ein SeekOrigin ist ungültig.

- oder -

offset hat einen arithmetischen Überlauf verursacht.

ObjectDisposedException

Der aktuelle Instanz des Streams ist geschlossen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MemoryStream-Klasse bereitgestellt wird.

// 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)

Hinweise

Diese Methode überschreibt Stream.Seek.

Das Suchen nach einem beliebigen Speicherort über die Länge des Datenstroms hinaus wird unterstützt.

Verwenden Sie die Seek -Methode nicht, um die neue Position im Stream zu bestimmen, wenn die MemoryStream mit einem Ungleich-Null-Offset initialisiert wurde. Wenn Sie dies tun, Seek wird ein ungenauer Wert zurückgegeben. Verwenden Sie stattdessen die Position -Eigenschaft, um die neue Position des Streams abzurufen.

Gilt für: