FileStream.Handle Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origine:
FileStream.cs
Origine:
FileStream.cs
Origine:
FileStream.cs

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 : 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

Valore della proprietà

IntPtr

nativeint

Handle di file del sistema operativo per il file incapsulato dall'oggetto FileStream oppure -1 se FileStream è stato chiuso.

Attributi
ObsoleteAttribute SecurityCriticalAttribute

Eccezioni

SecurityException

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.

Si applica a

Vedi anche