FileStream.Handle Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Attention
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202
Attention
FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.
Attention
This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202
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("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
Valeur de propriété
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
Exceptions
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
.
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour