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

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

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 o Length e Position propriedades para verificar se há 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 busca em 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 recentes, 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, os dados adicionados ao final do arquivo não estão definidos como zero, o que significa que os dados excluídos anteriormente está visível no 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 com um valor grande após o fim do fluxo no Windows 98 ou anterior pode resultar em uma exceção que está 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 diretório e arquivos comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Aplica-se a

Veja também