Stream.Seek(Int64, SeekOrigin) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

Stream.cs

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 dá 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 especificado por offset.

Classes derivadas dessa busca de Stream 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.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo