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 größeren Beispiels, das für die MemoryStream -Klasse bereitgestellt wird.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.

Das Suchen nach einem beliebigen Speicherort über die Länge des Streams wird unterstützt.Seeking to any location beyond the length of the stream is supported.

Verwenden Sie die Seek -Methode nicht, um die neue Position im Stream zu ermitteln MemoryStream , wenn der mit einem Offset ungleich 0 (null) 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 , gibt einen ungenauen Wert zurück.If you do, Seek will return an inaccurate value. Verwenden Sie stattdessen die Position -Eigenschaft, um die neue Position des Streams zu erhalten.Instead, use the Position property to get the new position of the stream.

Gilt für:

Siehe auch