FileStream.Position Propriedade

Definição

Obtém ou define a posição atual desse fluxo.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 da propriedade

Int64

A posição atual do fluxo.The current position of this stream.

Exceções

O fluxo não dá suporte à busca.The stream does not support seeking.

Ocorreu um erro de E/S.An I/O error occurred.

- ou --or-

A posição foi definida com um valor muito grande após o final do fluxo no Windows 98 ou anterior.The position was set to a very large value beyond the end of the stream in Windows 98 or earlier.

Tentativa de definir a posição com um valor negativo.Attempted to set the position to a negative value.

Tentativa de busca após o término de um fluxo que não dá suporte a essa operação.Attempted seeking past the end of a stream that does not support this.

Exemplos

O exemplo a seguir usa Length as Position Propriedades e para verificar uma condição de fim de arquivo.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

Comentários

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. Quando você busca além do comprimento do arquivo, o tamanho do arquivo aumenta.When you seek beyond the length of the file, the file size grows. No Microsoft Windows NT e mais recente, todos os dados adicionados ao final do arquivo são definidos como zero.In Microsoft Windows NT and newer, any data added to the end of the file is set to zero. No Microsoft Windows 98 ou anterior, todos os dados adicionados ao final do arquivo não são definidos como zero, o que significa que os dados excluídos anteriormente ficam visíveis para o fluxo.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. Definir a posição do fluxo para um valor grande além do fim do fluxo no Windows 98 ou anterior pode resultar em uma exceção sendo gerada.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 obter uma lista de operações de arquivo e diretório comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Aplica-se a

Confira também