GCHandleType-Enumeration
Stellt die Handletypen dar, die von der GCHandle-Klasse reserviert werden können.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration GCHandleType
'Usage
Dim instance As GCHandleType
[SerializableAttribute]
[ComVisibleAttribute(true)]
public enum GCHandleType
[SerializableAttribute]
[ComVisibleAttribute(true)]
public enum class GCHandleType
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
public enum GCHandleType
SerializableAttribute
ComVisibleAttribute(true)
public enum GCHandleType
Member
| Membername | Beschreibung | |
|---|---|---|
.gif) |
Normal | Dieser Handletyp stellt ein nicht transparentes Handle dar, d. h., dass die Adresse des fixierten Objekts nicht über das Handle aufgelöst werden kann. Sie können mit diesem Typ ein Objekt überwachen und verhindern, dass es vom Garbage Collector erfasst wird. Dieser Enumerationsmember ist nützlich, wenn ein nicht verwalteter Client den einzigen Verweis auf ein verwaltetes Objekt enthält, der vom Garbage Collector nicht erkannt werden kann. |
|
Pinned | Dieser Handletyp ähnelt Normal, lässt jedoch das Erfassen der Adresse des fixierten Objekts zu. Andernfalls wird das Verschieben des Objekts durch den Garbage Collector verhindert und somit dessen Effizienz verringert. Verwenden Sie die Free-Methode, um das reservierte Handle so bald wie möglich freizugeben. |
|
Weak | Dieser Handletyp wird zum Überwachen eines Objekts verwendet, lässt jedoch das Sammeln zu. Beim Sammeln eines Objekts wird der Inhalt von GCHandle auf 0 festgelegt. Weak-Verweise werden vor dem Ausführen des Finalizers auf 0 festgelegt. Selbst wenn der Finalizer das Objekt wieder zugänglich macht, ist der Weak-Verweis immer noch auf 0 festgelegt. |
|
WeakTrackResurrection | Dieser Handletyp ähnelt Weak, das Handle wird jedoch nicht auf 0 festgelegt, wenn das Objekt während der Finalisierung wieder zugänglich gemacht wird. |
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0