CriticalHandle Classe

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Source:

CriticalHandle.cs

Représente une classe wrapper pour les ressources de handle.

public ref class CriticalHandle abstract : System::Runtime::ConstrainedExecution::CriticalFinalizerObject, IDisposable

public abstract class CriticalHandle : System.Runtime.ConstrainedExecution.CriticalFinalizerObject, IDisposable

type CriticalHandle = class
    inherit CriticalFinalizerObject
    interface IDisposable

Public MustInherit Class CriticalHandle
Inherits CriticalFinalizerObject
Implements IDisposable

Héritage

Object

CriticalFinalizerObject

CriticalHandle

Dérivé

Microsoft.Win32.SafeHandles.CriticalHandleMinusOneIsInvalid

Microsoft.Win32.SafeHandles.CriticalHandleZeroOrMinusOneIsInvalid

Implémente

IDisposable

Remarques

La CriticalHandle classe est similaire à la SafeHandle classe , sauf que SafeHandle implémente le comptage des références. Vous pouvez utiliser CriticalHandle au lieu de SafeHandle pour répondre aux considérations relatives aux performances lorsque vous pouvez fournir vous-même la synchronisation nécessaire plus efficacement.

Étant donné que la CriticalHandle classe n’effectue pas de comptage de références, elle ne fournit pas de protection contre les attaques de sécurité de recyclage de gestion. Étant donné que l’algorithme de comptage de références sérialise implicitement les opérations, une certaine quantité de sécurité des threads est également perdue. Si vous appelez la IDisposable.Dispose méthode ou Close alors qu’une opération qui utilise le handle est en attente sur un autre thread, ou si vous appelez IDisposable.Dispose ou Close à partir de deux threads en même temps, les résultats ne sont pas déterministes. La CriticalHandle classe fournit toujours la finalisation critique garantie fournie par la CriticalFinalizerObject classe .

Constructeurs

CriticalHandle(IntPtr)

Initialise une nouvelle instance de la classe CriticalHandle avec la valeur de handle non valide spécifiée.

Champs

handle

Spécifie le handle à encapsuler.

Propriétés

IsClosed	Obtient une valeur indiquant si le handle est fermé.
IsInvalid	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si la valeur du handle n'est pas valide.

Méthodes

Close()	Marque le handle pour libérer des ressources.
Dispose()	Libère toutes les ressources utilisées par CriticalHandle.
Dispose(Boolean)	Libère les ressources non managées utilisées par la classe CriticalHandle, en spécifiant s'il faut exécuter une opération de suppression normale.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Finalize()	Libère toutes les ressources associées au handle.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ReleaseHandle()	En cas de substitution dans une classe dérivée, exécute le code nécessaire pour libérer le handle.
SetHandle(IntPtr)	Définit le handle au handle préexistant spécifié.
SetHandleAsInvalid()	Marque un handle comme non valide.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• SafeHandle
• Microsoft.Win32.SafeHandles