FileStream.Handle Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Attenzione
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202
Attenzione
FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.
Attenzione
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202
Ottiene l'handle di file del sistema operativo per il file incapsulato dall'oggetto FileStream.
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 IntPtrValore della proprietà
nativeint
Handle di file del sistema operativo per il file incapsulato dall'oggetto FileStream oppure -1 se FileStream è stato chiuso.
- Attributi
Eccezioni
Il chiamante non dispone dell'autorizzazione richiesta.
Commenti
Questa proprietà è un handle del sistema operativo da usare con chiamate di sistema fornite dal sistema operativo ,ad esempio ReadFile in Windows. Non funzionerà con le funzioni della libreria C che prevedono un descrittore di file, ad esempio fread.
L'handle del sistema operativo potrebbe essere stato aperto in modo sincrono o asincrono, a seconda del FileStream costruttore chiamato. Utilizzare la proprietà per individuare se questo IsAsync handle è stato aperto in modo asincrono. In Win32 questo significa che l'handle è stato aperto per l'I/O sovrapposto e richiede parametri diversi a ReadFile e WriteFile.
Attenzione
Il danneggiamento dei dati potrebbe verificarsi se viene FileStream creato un oggetto, il relativo handle viene passato, alcune operazioni spostano il puntatore del file dell'handle e quindi viene FileStream usato di nuovo. Più thread non possono scrivere in modo sicuro nello stesso file contemporaneamente e FileStream il codice di buffering presuppone che controlli esclusivamente l'handle. FileStream potrebbe generare un IOException se FileStream rileva che un altro processo ha spostato il puntatore al file. Per evitare questo problema, non scrivere dati in una parte del file che FileStream potrebbe essere stato memorizzato nel buffer e ripristinare il puntatore al percorso in cui erano stati chiamati i metodi in FileStream.
