MemoryStream.Seek(Int64, SeekOrigin) Метод

Определение

Задает указанное значение для положения в текущем потоке.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

Параметры

offset
Int64

Новое положение в потоке.The new position within the stream. Оно определяется относительно параметра loc и может быть положительным или отрицательным.This is relative to the loc parameter, and can be positive or negative.

loc
SeekOrigin

Значение типа SeekOrigin, которое действует как точка ссылки поиска.A value of type SeekOrigin, which acts as the seek reference point.

Возвращаемое значение

Int64

Новое положение в потоке, вычисляемое путем объединения смещения и исходной точки ссылки.The new position within the stream, calculated by combining the initial reference point and the offset.

Исключения

Попытка поиска выполняется до начала потока.Seeking is attempted before the beginning of the stream.

Значение offset больше значения MaxValue.offset is greater than MaxValue.

SeekOrigin недопустим.There is an invalid SeekOrigin.

-или--or- Значение offset вызвало арифметическое переполнение.offset caused an arithmetic overflow.

Текущий экземпляр потока закрыт.The current stream instance is closed.

Примеры

Этот пример кода является частью большого примера, приведенного для класса MemoryStream.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)

Комментарии

Этот метод переопределяет метод Stream.Seek.This method overrides Stream.Seek.

Поддерживается поиск в любом расположении, превышающем длину потока.Seeking to any location beyond the length of the stream is supported.

Не используйте метод Seek для определения новой позиции в потоке, если MemoryStream был инициализирован с ненулевым смещением.Do not use the Seek method to determine the new position in the stream if the MemoryStream was initialized with a non-zero offset. В этом случае Seek вернет неточное значение.If you do, Seek will return an inaccurate value. Вместо этого используйте свойство Position, чтобы получить новую точку потока.Instead, use the Position property to get the new position of the stream.

Применяется к

Дополнительно