FileStream.Position Propriedade

Definição

Namespace:
System.IO
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
netstandard.dll

Obtém ou define a posição atual desse fluxo.

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 desse fluxo.

Exceções

NotSupportedException

O fluxo não dá suporte à busca.

IOException

Ocorreu um erro de E/S.

ArgumentOutOfRangeException

Tentou definir a posição como um valor negativo.

EndOfStreamException

Tentativa de busca após o final de um fluxo que não dá suporte a isso.

Exemplos

O exemplo a seguir usa as Length propriedades e Position para verificar se há uma condição de fim de arquivo.

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

if s.Length = s.Position then
    printfn "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 procurar qualquer local além do comprimento do fluxo. Quando você busca além do comprimento do arquivo, o tamanho do arquivo aumenta. Todos os dados adicionados ao final do arquivo são definidos como zero.

Para obter uma lista de operações comuns de arquivo e diretório, consulte Tarefas comuns de E/S.

Aplica-se a

Confira também