FileStream.Handle Propriété

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

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 fonctionne pas avec les fonctions de bibliothèque C qui attendent un descripteur de fichier, comme fread.

Le handle du système d’exploitation a peut-être été ouvert de manière synchrone ou asynchrone, selon le constructeur qui FileStream a été appelé. 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 superposées, 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 est créé, que son handle est passé, qu’une FileStream opération déplace le pointeur de fichier du handle, puis que le FileStream est à nouveau utilisé. Plusieurs threads ne peuvent pas écrire simultanément dans le même fichier en toute sécurité, 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 avoir été mise en mémoire tampon, et restaurez le pointeur de fichier vers l’emplacement qu’il avait lorsque les méthodes ont été appelées pour la dernière fois sur FileStream.

Voir aussi

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