MemoryStream.Seek(Int64, SeekOrigin) Methode
Definition
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 innerhalb des aktuellen Datenstroms 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 Datenstroms. Dies ist relativ zum loc Parameter und kann positiv oder negativ sein.
- loc
- SeekOrigin
Ein Wert vom Typ SeekOrigin, der als Suchbezugspunkt fungiert.
Gibt zurück
Die neue Position innerhalb des Datenstroms, berechnet durch Die Kombination des anfänglichen Bezugspunkts und des Offsets.
Ausnahmen
Die Suche wird vor dem Beginn des Datenstroms versucht.
offset ist größer als Int32.MaxValue.
Es ist ein ungültiger SeekOriginWert vorhanden.
-oder-
offset verursachte einen arithmetischen Überlauf.
Die aktuelle Streaminstanz wird geschlossen.
Beispiele
Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MemoryStream Klasse bereitgestellt wird.
// 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.
Die Suche 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 Datenstrom zu ermitteln, wenn der MemoryStream Wert mit einem Offset ungleich Null initialisiert wurde. Wenn Sie dies tun, Seek wird ein ungenauer Wert zurückgegeben. Verwenden Sie stattdessen die Position Eigenschaft, um die neue Position des Datenstroms abzurufen.