GCHandleType Énumération

Définition

Espace de noms:
System.Runtime.InteropServices
Assemblys:
mscorlib.dll, System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

Représente les types de handles que le type GCHandle peut allouer.

public enum class GCHandleType
public enum GCHandleType
[System.Serializable]
public enum GCHandleType
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum GCHandleType
type GCHandleType = 
[<System.Serializable>]
type GCHandleType = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GCHandleType = 
Public Enum GCHandleType
Héritage
Object
ValueType
Enum
GCHandleType
Attributs
SerializableAttribute ComVisibleAttribute

Champs

Nom Valeur Description
Weak 0

Ce type de handle est utilisé pour suivre un objet, mais il peut être collecté. Lorsqu’un objet est collecté, le contenu du GCHandle fichier est zéro. Weak les références sont nulles avant l’exécution du finaliseur. Par conséquent, même si le finaliseur ressuscitit l’objet, la Weak référence est toujours nulle.
WeakTrackResurrection 1

Ce type de handle est similaire à Weak, mais le handle n’est pas zéro si l’objet est ressuscité lors de la finalisation.
Normal 2

Ce type de handle représente un handle opaque, ce qui signifie que vous ne pouvez pas résoudre l’adresse de l’objet épinglé via le handle. Vous pouvez utiliser ce type pour suivre un objet et empêcher son regroupement par le garbage collector. Ce membre d’énumération est utile lorsqu’un client non géré contient la seule référence, qui n’est pas détectable du garbage collector, à un objet managé.
Pinned 3

Ce type de handle est similaire à Normal, mais autorise la prise de l’adresse de l’objet épinglé. Cela empêche le garbage collector de déplacer l’objet et donc de compromettre l’efficacité du garbage collector. Utilisez la Free() méthode pour libérer le handle alloué dès que possible.

S’applique à

Voir aussi