Stream.Seek(Int64, SeekOrigin) Método

Definición

Cuando se reemplaza en una clase derivada, se establece la posición dentro de la secuencia actual.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

Desplazamiento de bytes relacionado con el parámetro origin.A byte offset relative to the origin parameter.

origin
SeekOrigin

Valor de tipo SeekOrigin que indica el punto de referencia utilizado para obtener la nueva posición.A value of type SeekOrigin indicating the reference point used to obtain the new position.

Devoluciones

La nueva posición en la secuencia actual.The new position within the current stream.

Excepciones

Error de E/S.An I/O error occurs.

La secuencia no admite búsquedas, como en el caso donde la secuencia se cree a partir de los resultados de una canalización o consola.The stream does not support seeking, such as if the stream is constructed from a pipe or console output.

Se efectuó una llamada a los métodos después de cerrar la secuencia.Methods were called after the stream was closed.

Comentarios

Use la propiedad CanSeek para determinar si la instancia actual admite búsquedas.Use the CanSeek property to determine whether the current instance supports seeking.

Si offset es negativo, la nueva posición debe preceder a la posición especificada por origin por el 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. Si offset es cero (0), es necesario que la nueva posición sea la posición especificada por origin.If offset is zero (0), the new position is required to be the position specified by origin. Si offset es positivo, la nueva posición debe seguir la posición especificada por origin por el número de bytes especificado 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.

Las clases derivadas de Stream que admiten búsquedas deben invalidar este método para proporcionar la funcionalidad descrita anteriormente.Classes derived from Stream that support seeking must override this method to provide the functionality described above.

Se admite la búsqueda en cualquier ubicación más allá de la longitud de la secuencia.Seeking to any location beyond the length of the stream is supported.

Se aplica a

Consulte también: