FileStream.Handle Propriété

Définition

Espace de noms:

System.IO

Assemblys:

netstandard.dll, 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 pour le fichier encapsulé par l’objet actuel 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

Valeur de propriété

IntPtr

nativeint

Handle de fichier du système d’exploitation pour le fichier encapsulé par cet FileStream objet, ou -1 si le FileStream fichier 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 des 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, tel que fread.

Le handle du système d’exploitation a peut-être été ouvert de manière synchrone ou asynchrone, selon le FileStream constructeur appelé. Utilisez la IsAsync propriété pour déterminer 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és, et qu’il nécessite différents paramètres à ReadFile et WriteFile.

Avertissement

L’altération des données peut se produire si un FileStream handle est créé, son handle est passé, certaines opérations déplacent le pointeur de fichier du handle, puis le FileStream réutilisent. Plusieurs threads ne peuvent pas écrire en toute sécurité dans le même fichier simultanément, et FileStream le code de mise en mémoire tampon suppose qu’il contrôle exclusivement le handle. FileStream peut lever une IOException exception si FileStream elle détecte que d’autres processus ont déplacé le pointeur de fichier. Pour éviter cela, n’écrivez pas de données dans une partie du fichier susceptible FileStream d’avoir mis en mémoire tampon et restaurez le pointeur de fichier à l’emplacement où les méthodes ont été appelées FileStreampour la dernière fois.

Voir aussi

• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier