Compartilhar via


FileStream.Handle Propriedade

Definição

Cuidado

This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202

Cuidado

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

Cuidado

This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202

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("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }
[System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }
public virtual IntPtr Handle { get; }
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { [System.Security.SecurityCritical] get; }
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeint
[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
member this.Handle : nativeint
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeint
member this.Handle : nativeint
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
[<get: System.Security.SecurityCritical>]
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

Exceções

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.

Aplica-se a

Confira também