FileStream.Handle Propriété

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

FileStream.cs

Attention

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

Obtient le handle de fichier du système d'exploitation que l'objet FileStream actuel encapsule.

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

Valeur de propriété

IntPtr

nativeint

Handle de fichier du système d'exploitation pour le fichier encapsulé par cet objet FileStream, ou -1 si l'élément FileStream a été fermé.

Attributs

ObsoleteAttribute

Exceptions

SecurityException

L'appelant n'a pas l'autorisation requise.

Remarques

Cette propriété est un handle de système d’exploitation à utiliser avec les appels système fournis par le système d’exploitation (par ReadFile exemple sur Windows). Il ne fonctionnera pas avec les fonctions de bibliothèque C qui attendent un descripteur de fichier, comme fread.

Le handle du système d’exploitation peut avoir été ouvert de manière synchrone ou asynchrone, selon le constructeur appelé FileStream . Utilisez la IsAsync propriété pour découvrir si ce handle a été ouvert de manière asynchrone. Dans Win32, cela signifie que le handle a été ouvert pour les E/S qui se chevauchent, et qu’il nécessite des paramètres différents pour ReadFile et WriteFile.

Attention

Une altération des données peut se produire si un FileStream est créé, si son handle est passé, si une opération déplace le pointeur de fichier du handle, puis si le FileStream est à nouveau utilisé. Plusieurs threads ne peuvent pas écrire simultanément dans le même fichier, et FileStream le code de mise en mémoire tampon suppose qu’il contrôle exclusivement le handle. FileStream peut lever un IOException si FileStream détecte qu’un autre processus a déplacé le pointeur de fichier. Pour éviter cela, n’écrivez pas de données dans une partie du fichier qui FileStream a pu être mise en mémoire tampon, et restaurez le pointeur de fichier vers l’emplacement où il était à l’emplacement où les méthodes ont été appelées pour la dernière fois sur FileStream.

Voir aussi

• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier