Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

GC.WaitForFullGCComplete-Methode: ()

 

Veröffentlicht: Oktober 2016

Gibt den Status einer registrierten Benachrichtigung zurück, um zu bestimmen, ob eine vollständige blockierende Garbage Collection durch die Common Language Runtime abgeschlossen wurde.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

[SecurityCriticalAttribute]
public static GCNotificationStatus WaitForFullGCComplete()

Rückgabewert

Type: System.GCNotificationStatus

Der Status der registrierten Garbage Collection-Benachrichtigung.

Verwenden der GCNotificationStatus Enumeration zurückgegeben, die von dieser Methode den Status der aktuellen Garbage Collection-Benachrichtigung zu ermitteln, die mit registriert wurde die RegisterForFullGCNotification Methode. Sie können auch die WaitForFullGCApproach Methode, um zu bestimmen, ob eine vollständige Garbagecollection bevorsteht.

Wenn die Enumeration gibt Succeeded, erreichen Sie Aufgaben wie das Fortsetzen der Arbeit und Abrufen der Anzahl der Auflistung mit den CollectionCount Eigenschaft.

Diese Methode wartet unbegrenzt auf eine Garbage Collection-Benachrichtigung abgerufen werden soll. Wenn geben Sie einen Timeoutzeitraum für die Methode zurück, wenn die Benachrichtigung kann nicht abgerufen werden sollen, verwenden Sie die GC.WaitForFullGCApproach(Int32) -methodenüberladung. Wenn Sie diese Methode aufrufen, ohne dass einen Timeout, können Sie rufen die CancelFullGCNotification Methode, wenn Sie länger als bevorzugter warten.

Dieser Methodenaufruf muss mit einem Aufruf von vorangestellt werden die WaitForFullGCApproach Methode, um sicherzustellen, dass Sie eine vollständige Garbagecollection hatten. Beim Aufrufen dieser Methode allein kann zu unbestimmte Ergebnissen führen.

Das folgende Beispiel zeigt, wie diese Methode verwendet, um zu bestimmen, ob eine vollständige Garbagecollection abgeschlossen wurde. Wenn der Status der Benachrichtigung ist Succeeded, die Benutzermethode OnFullGCCompletedNotify wird aufgerufen, um Aktionen als Reaktion auf die vollständige Auflistung ausführen. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für Garbage Collection Notifications Thema.

// Check for a notification of a completed collection.
s = GC.WaitForFullGCComplete();
if (s == GCNotificationStatus.Succeeded)
{
    Console.WriteLine("GC Notifiction raised.");
    OnFullGCCompleteEndNotify();
}
else if (s == GCNotificationStatus.Canceled)
{
    Console.WriteLine("GC Notification cancelled.");
    break;
}
else
{
    // Could be a time out.
    Console.WriteLine("GC Notification not applicable.");
    break;
}

LinkDemand

for full trust for the immediate caller. This member cannot be used by partially trusted code.

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: