FileStream.Handle Propriedade

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

FileStream.cs

Cuidado

FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.

Obtém o identificador de arquivo do sistema operacional do arquivo que o objeto FileStream atual encapsula.

public:
 virtual property IntPtr Handle { IntPtr get(); };

[System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }

[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
member this.Handle : nativeint

Public Overridable ReadOnly Property Handle As IntPtr

Valor da propriedade

IntPtr

nativeint

O identificador de arquivo do sistema operacional para o arquivo encapsulado por esse objeto FileStream ou -1 se o FileStream tiver sido fechado.

Atributos

ObsoleteAttribute

Exceções

SecurityException

O chamador não tem a permissão necessária.

Comentários

Essa propriedade é um identificador do sistema operacional para uso com chamadas do sistema operacional fornecidas pelo sistema (como ReadFile no Windows). Ele não funcionará com funções de biblioteca C que esperam um descritor de arquivo, como fread.

O identificador do sistema operacional pode ter sido aberto de forma síncrona ou assíncrona, dependendo de qual FileStream construtor foi chamado. Use a IsAsync propriedade para descobrir se esse identificador foi aberto de forma assíncrona. No Win32, isso significa que o identificador foi aberto para E/S sobreposta e requer parâmetros diferentes para ReadFile e WriteFile.

Cuidado

A corrupção de dados poderá ocorrer se um FileStream for criado, seu identificador for passado, alguma operação mover o ponteiro de arquivo do identificador e, em seguida, o FileStream for usado novamente. Vários threads não podem gravar com segurança no mesmo arquivo simultaneamente, e FileStream o código de buffer pressupõe que ele controla exclusivamente o identificador. FileStream pode gerar um IOException se FileStream detectar que algum outro processo moveu o ponteiro do arquivo. Para evitar isso, não escreva nenhum dado em uma parte do arquivo que FileStream possa ter armazenado em buffer e restaure o ponteiro do arquivo para o local que ele tinha quando os métodos foram chamados pela última vez em FileStream.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo