BufferedStream.Seek(Int64, SeekOrigin) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define a posição dentro do 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 relativo a origin.
- origin
- SeekOrigin
Um valor de tipo SeekOrigin que indica o ponto de referência do qual obter a nova posição.
Retornos
A nova posição dentro do fluxo em buffer atual.
Exceções
O fluxo não está aberto ou está null.
O fluxo não dá suporte à busca.
Os métodos foram chamados depois que o fluxo foi fechado.
Comentários
Se offset for negativo, a nova posição precederá a posição especificada pelo origin 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 pelo origin 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.