FileStream.Handle Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Atenção
FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.
Atenção
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202
Atenção
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202
Obtém o handle do ficheiro do sistema operativo para o ficheiro que o objeto atual FileStream 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("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("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("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. https://go.microsoft.com/fwlink/?linkid=14202")>]
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 de Propriedade
nativeint
O handle do ficheiro do sistema operativo para o ficheiro encapsulado por este FileStream objeto, ou -1 se tiver FileStream sido fechado.
- Atributos
Exceções
O interlocutor não tem a permissão necessária.
Observações
Esta propriedade é um handle do sistema operativo para uso com chamadas de sistema fornecidas pelo sistema operativo (como ReadFile em Windows). Não funciona com funções da biblioteca C que esperam um descritor de ficheiro, como fread.
O handle do sistema operativo podia ter sido aberto de forma síncrona ou assíncrona, dependendo do FileStream construtor chamado. Use a IsAsync propriedade para descobrir se este handle foi aberto de forma assíncrona. No Win32, isto significa que a alavanca foi aberta para E/S sobreposta, e requer parâmetros diferentes para ReadFile e WriteFile.
Atenção
Pode ocorrer corrupção de dados se um FileStream for criado, o seu handle for passado, alguma operação mover o ponteiro do ficheiro do handle e depois FileStream for usado novamente. Múltiplas threads não podem escrever em segurança no mesmo ficheiro simultaneamente, e FileStream o código de buffering assume que controla exclusivamente o handle.
FileStream Pode lançar um IOException se FileStream que deteta que algum outro processo moveu o ponteiro do ficheiro. Para evitar isto, não escreva quaisquer dados numa parte do ficheiro que FileStream possa ter sido armazenada em buffer, e restaure o ponteiro do ficheiro para a localização que tinha quando os métodos foram chamados FileStreampela última vez.
