Stream.Seek(Int64, SeekOrigin) Método

Definição

Quando substituído em uma classe derivada, define a posição dentro do fluxo atual.When overridden in a derived class, sets the position within the current stream.

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.A byte offset relative to the origin parameter.

origin
SeekOrigin

Um valor do tipo SeekOrigin indicando o ponto de referência usado para obter a nova posição.A value of type SeekOrigin indicating the reference point used to obtain the new position.

Retornos

Int64

A nova posição dentro do fluxo atual.The new position within the current stream.

Exceções

Ocorre um erro de E/S.An I/O error occurs.

O fluxo não dá suporte à busca, como se o fluxo fosse construído por meio de uma saída do console ou pipe.The stream does not support seeking, such as if the stream is constructed from a pipe or console output.

Foram chamados métodos depois que o fluxo foi fechado.Methods were called after the stream was closed.

Comentários

Use a CanSeek propriedade para determinar se a instância atual oferece suporte à busca.Use the CanSeek property to determine whether the current instance supports seeking.

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 .If offset is negative, the new position is required to precede the position specified by origin by the number of bytes specified by offset. Se offset for zero (0), a nova posição será necessária para ser a posição especificada por origin .If offset is zero (0), the new position is required to be the position specified by 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 .If offset is positive, the new position is required to follow the position specified by origin by the number of bytes specified by offset.

Classes derivadas dessa Stream pesquisa de suporte devem substituir esse método para fornecer a funcionalidade descrita acima.Classes derived from Stream that support seeking must override this method to provide the functionality described above.

Há suporte para a busca de qualquer local além do comprimento do fluxo.Seeking to any location beyond the length of the stream is supported.

Aplica-se a