Partager via


FileStream.Handle Propriété

Définition

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é

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

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 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.

S’applique à

Voir aussi