MemoryStream.Seek(Int64, SeekOrigin) MemoryStream.Seek(Int64, SeekOrigin) MemoryStream.Seek(Int64, SeekOrigin) MemoryStream.Seek(Int64, SeekOrigin) Method

Definition

Legt die Position im aktuellen Stream auf den angegebenen Wert fest.Sets the position within the current stream to the specified value.

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

Die neue Position innerhalb des Streams.The new position within the stream. Diese ist relativ zum loc-Parameter und kann positiv oder negativ sein.This is relative to the loc parameter, and can be positive or negative.

loc
SeekOrigin SeekOrigin SeekOrigin SeekOrigin

Ein Wert vom Typ SeekOrigin, der den Bezugspunkt für die Suche darstellt.A value of type SeekOrigin, which acts as the seek reference point.

Gibt zurück

Die neue Position im Stream, die durch Kombinieren des anfänglichen Verweispunktes und des Offsets berechnet wird.The new position within the stream, calculated by combining the initial reference point and the offset.

Ausnahmen

Es wird versucht, vor Beginn des Streams eine Suche auszuführen.Seeking is attempted before the beginning of the stream.

Ein SeekOrigin ist ungültig.There is an invalid SeekOrigin.

- oder --or- offset hat einen arithmetischen Überlauf verursacht.offset caused an arithmetic overflow.

Der aktuelle Instanz des Streams ist geschlossen.The current stream instance is closed.

Beispiele

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die MemoryStream Klasse.This code example is part of a larger example provided for the MemoryStream class.

// 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.This method overrides Stream.Seek.

An einem beliebigen Speicherort über die Länge des Streams hinaus Suchvorgänge werden unterstützt.Seeking to any location beyond the length of the stream is supported.

Verwenden Sie nicht die Seek Methode, um die neue Position im Stream festzulegen, wenn die MemoryStream mit einem NULL-Offset initialisiert wurde.Do not use the Seek method to determine the new position in the stream if the MemoryStream was initialized with a non-zero offset. Wenn Sie dies tun, Seek einen fehlerhaften Wert zurück.If you do, Seek will return an inaccurate value. Verwenden Sie stattdessen die Position Eigenschaft, um die neue Position im Stream abzurufen.Instead, use the Position property to get the new position of the stream.

Gilt für:

Siehe auch