Stream.Seek(Int64, SeekOrigin) Método

Referência

Definição

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

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.

Quando substituído em uma classe derivada, define a posição dentro do fluxo atual.

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

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

abstract member Seek : int64 * System.IO.SeekOrigin -> int64

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

Parâmetros

offset: Int64

Um deslocamento de bytes em relação ao parâmetro origin.

origin: SeekOrigin

Um valor do tipo SeekOrigin indicando o ponto de referência usado para obter a nova posição.

Retornos

Int64

A nova posição dentro do fluxo atual.

Exceções

IOException

Ocorre um erro de E/S.

NotSupportedException

O fluxo não dá suporte à busca, como se o fluxo fosse construído por meio de uma saída do console ou pipe.

ObjectDisposedException

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

Comentários

Use a CanSeek propriedade para determinar se a instância atual oferece suporte à busca.

Se offset for negativo, a nova posição será necessária para preceder a posição especificada pelo origin número de bytes especificado por offset . Se offset for zero (0), a nova posição será necessária para ser a posição especificada por origin . Se offset for positivo, a nova posição será necessária para seguir a posição especificada pelo origin número de bytes especificados por offset .

Classes derivadas dessa Stream pesquisa de suporte devem substituir esse método para fornecer a funcionalidade descrita acima.

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

Aplica-se a