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

Definição

Define a posição no fluxo atual com o valor especificado.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

Parâmetros

offset
Int64 Int64 Int64 Int64

A nova posição no fluxo.The new position within the stream. Isso é relativo ao parâmetro loc e pode ser positivo ou negativo.This is relative to the loc parameter, and can be positive or negative.

loc
SeekOrigin SeekOrigin SeekOrigin SeekOrigin

Um valor do tipo SeekOrigin, que atua como o ponto de referência de busca.A value of type SeekOrigin, which acts as the seek reference point.

Retornos

A nova posição no fluxo, calculada pela combinação do ponto de referência inicial e do deslocamento.The new position within the stream, calculated by combining the initial reference point and the offset.

Exceções

A busca é tentada antes do início do fluxo.Seeking is attempted before the beginning of the stream.

Há um SeekOrigin inválido.There is an invalid SeekOrigin.

- ou --or- O offset causou um estouro aritmético.offset caused an arithmetic overflow.

A instância atual do fluxo está fechada.The current stream instance is closed.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para MemoryStream a classe.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)

Comentários

Este método substitui Stream.Seek.This method overrides Stream.Seek.

Há suporte para a busca de qualquer local além do comprimento do fluxo.Seeking to any location beyond the length of the stream is supported.

Não use o Seek método para determinar a nova posição no fluxo se o MemoryStream tiver sido inicializado com um deslocamento diferente de zero.Do not use the Seek method to determine the new position in the stream if the MemoryStream was initialized with a non-zero offset. Se você fizer isso Seek , o retornará um valor impreciso.If you do, Seek will return an inaccurate value. Em vez disso, Position use a propriedade para obter a nova posição do fluxo.Instead, use the Position property to get the new position of the stream.

Aplica-se a

Veja também