FileStream.Handle Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : nativeintmember 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 : nativeintPublic Overridable ReadOnly Property Handle As IntPtrValor da propriedade
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.
