Compartilhar via


BufferedStream.Seek(Int64, SeekOrigin) Método

Definição

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

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

Exceções

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

O fluxo não dá suporte à busca.

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.

Aplica-se a

Confira também