FileStream.Handle Propriedade

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

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

Cuidado

Use SafeFileHandle 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("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; }
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; }
[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("Use SafeFileHandle 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")>]
member this.Handle : nativeint
[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
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")>]
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
[<System.Obsolete("Use SafeFileHandle 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 SecurityCriticalAttribute

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 de sistema fornecidas pelo sistema operacional (como ReadFile no Windows). Ele não funcionará com as funções da 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 pode ocorrer se um FileStream for criado, seu identificador é passado, alguma operação move o ponteiro do arquivo do identificador e, em seguida, o FileStream é usado novamente. Vários threads não podem gravar com segurança no mesmo arquivo simultaneamente, e o FileStream 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 grave nenhum dado em uma parte do arquivo que FileStream possa ter o buffer e restaure o ponteiro do arquivo para o local em que ele tinha quando os métodos foram chamados pela última vez FileStream .

Aplica-se a

Confira também