MemoryStream.Seek(Int64, SeekOrigin) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

MemoryStream.cs

Define a posição no fluxo atual com o valor especificado.

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

A nova posição no fluxo. Isso é relativo ao parâmetro loc e pode ser positivo ou negativo.

loc

SeekOrigin

Um valor do tipo SeekOrigin, que atua como o ponto de referência de busca.

Retornos

Int64

A nova posição no fluxo, calculada pela combinação do ponto de referência inicial e do deslocamento.

Exceções

IOException

A busca é tentada antes do início do fluxo.

ArgumentOutOfRangeException

offset é maior que Int32.MaxValue.

ArgumentException

Há um SeekOrigin inválido.

- ou -

O offset causou um estouro aritmético.

ObjectDisposedException

A instância atual do fluxo está fechada.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a MemoryStream classe .

// 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.

Há suporte para a busca de qualquer local além do comprimento do fluxo.

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. Se você fizer isso, Seek retornará um valor impreciso. Em vez disso, use a Position propriedade para obter a nova posição do fluxo.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo