FileStream.Handle Proprietà

Definizione

Spazio dei nomi:

System.IO

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

FileStream.cs

Attenzione

FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.

Ottiene l'handle di file del sistema operativo per il file incapsulato dall'oggetto corrente FileStream .

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("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
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 da questo FileStream oggetto o -1 se è FileStream stato chiuso.

Attributi

ObsoleteAttribute

Eccezioni

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Questa proprietà è un handle del sistema operativo da usare con le 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 IsAsync proprietà per determinare se questo handle è stato aperto in modo asincrono. In Win32 questo significa che l'handle è stato aperto per le operazioni di I/O sovrapposte e richiede parametri diversi per ReadFile e WriteFile.

Attenzione

Il danneggiamento dei dati può verificarsi se un FileStream oggetto viene creato, viene passato il relativo handle, alcune operazioni spostano il puntatore al file dell'handle e quindi FileStream vengono usate 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'eccezione 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 avere memorizzato nel buffer e ripristinare il puntatore al file nel percorso in cui si trovava quando i metodi sono stati chiamati per l'ultima volta su FileStream.

Vedi anche

• I/O di file e di flussi
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file