BufferedStream.Seek(Int64, SeekOrigin) Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assembly:
System.IO.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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 procurar qualquer local além do comprimento do fluxo.

Aplica-se a

Confira também