FileStream.Position FileStream.Position FileStream.Position FileStream.Position Property

Definición

Obtiene o establece la posición actual de esta secuencia.Gets or sets the current position of this stream.

public:
 virtual property long Position { long get(); void set(long value); };
public override long Position { get; set; }
member this.Position : int64 with get, set
Public Overrides Property Position As Long

Valor de propiedad

Posición actual de esta secuencia.The current position of this stream.

Excepciones

La secuencia no admite búsqueda.The stream does not support seeking.

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

o bien-or-

La posición se estableció en un valor muy grande más allá del final de la secuencia en Windows 98 o versiones anteriores.The position was set to a very large value beyond the end of the stream in Windows 98 or earlier.

Se intentó establecer la posición en un valor negativo.Attempted to set the position to a negative value.

Se intentó buscar más allá del final de una secuencia que no admite esto.Attempted seeking past the end of a stream that does not support this.

Ejemplos

En el ejemplo siguiente se Length usan Position las propiedades y para comprobar si hay una condición de final de archivo.The following example uses the Length and Position properties to check for an end-of-file condition.

if ( s->Length == s->Position )
{
   Console::WriteLine( "End of file has been reached." );
}
if( s.Length==s.Position )
{
   Console.WriteLine("End of file has been reached.");
}
If s.Length = s.Position Then
    Console.WriteLine("End of file has been reached.")
End If

Comentarios

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. Cuando busca más allá de la longitud del archivo, el tamaño del archivo aumenta.When you seek beyond the length of the file, the file size grows. En Microsoft Windows NT y versiones más recientes, los datos agregados al final del archivo se establecen en cero.In Microsoft Windows NT and newer, any data added to the end of the file is set to zero. En Microsoft Windows 98 o versiones anteriores, los datos agregados al final del archivo no se establecen en cero, lo que significa que los datos eliminados anteriormente son visibles para la secuencia.In Microsoft Windows 98 or earlier, any data added to the end of the file is not set to zero, which means that previously deleted data is visible to the stream. Si se establece la posición de la secuencia en un valor grande más allá del final de la secuencia en Windows 98 o una versión anterior, se puede producir una excepción.Setting the position of the stream to a large value beyond the end of the stream in Windows 98 or earlier may result in an exception being raised.

Para obtener una lista de operaciones comunes de archivos y directorios, vea tareas de e/s comunes.For a list of common file and directory operations, see Common I/O Tasks.

Se aplica a

Consulte también: