BufferedStream.Seek(Int64, SeekOrigin) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

BufferedStream.cs

Define a posição no fluxo em buffer atual.

public:
 override long Seek(long offset, System::IO::SeekOrigin origin);

public override long Seek (long offset, System.IO.SeekOrigin origin);

override this.Seek : int64 * System.IO.SeekOrigin -> int64

Public Overrides Function Seek (offset As Long, origin As SeekOrigin) As Long

Parâmetros

offset

Int64

Um deslocamento de bytes em relação a origin.

origin

SeekOrigin

Um valor do tipo SeekOrigin que indica o ponto de referência do qual a nova posição será obtida.

Retornos

Int64

A nova posição no fluxo em buffer atual.

Exceções

IOException

O fluxo não está aberto ou é null.

NotSupportedException

O fluxo não dá suporte à busca.

ObjectDisposedException

Foram chamados métodos depois que o fluxo foi fechado.

Comentários

Se offset for negativo, a nova posição precederá a posição especificada pela origin pelo número de bytes especificado por offset. Se offset for 0, a nova posição será a posição especificada por origin. Se offset for positivo, a nova posição seguirá a posição especificada pela origin pelo número de bytes especificado por offset.

Quando um BufferedStream objeto é o fluxo base de um StreamReader objeto, chamar o Seek método pode fazer com que a posição do fluxo não corresponda mais à posição do buffer interno no leitor. Para redefinir o buffer interno, chame o StreamReader.DiscardBufferedData método ; no entanto, esse método reduz o desempenho e deve ser chamado somente quando absolutamente necessário.

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

Confira também

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