BufferedStream.Seek(Int64, SeekOrigin) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define a posição dentro do fluxo atual em buffer.
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 de tipo SeekOrigin que indica o ponto de referência a partir do qual se deve obter a nova posição.
Devoluções
A nova posição dentro do fluxo atual em buffer.
Exceções
O fluxo não está aberto ou está null.
O stream não suporta a procura.
Os métodos foram chamados após o encerramento do riacho.
Observações
Se offset for negativo, a nova posição precederá a posição especificada por 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 por 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 deixe de corresponder à posição do buffer interno no leitor. Para reiniciar o buffer interno, chama o StreamReader.DiscardBufferedData método; no entanto, este método abranda o desempenho e só deve ser chamado quando absolutamente necessário.
A procura para qualquer local além do comprimento do riacho é suportada.