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.WaitForFullGCApproach-Methode: (Int32)

 

Veröffentlicht: Oktober 2016

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

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

[SecurityCriticalAttribute]
public static GCNotificationStatus WaitForFullGCApproach(
	int millisecondsTimeout
)

Parameter

millisecondsTimeout
Type: System.Int32

Die Dauer der Wartezeit, bevor ein Benachrichtigungsstatus abgerufen werden kann. Geben Sie -1 an, um unbegrenzt zu warten.

Rückgabewert

Type: System.GCNotificationStatus

Der Status der registrierten Garbage Collection-Benachrichtigung.

Exception Condition
ArgumentOutOfRangeException

millisecondsTimeout muss entweder nicht negativ bzw. kleiner oder gleich MaxValue oder -1 sein.

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 WaitForFullGCComplete Methode, um zu bestimmen, ob die vollständige Garbagecollection abgeschlossen wurde.

Beachten Sie, die diese Methode zurückgibt, sofort bei jedem Garbage Collection-Benachrichtigungsstatus abgerufen wird, unabhängig von dem angegebenen Wert millisecondsTimeout. Wenn eine Garbage Collection-Benachrichtigungsstatus nicht vor dem abgerufen wird millisecondsTimeout Zeiten, diese Methode gibt NotApplicable.

Wenn die Enumeration gibt Succeeded, erreichen Sie Aufgaben, z. B. verhindern, dass zusätzliche Objekte reserviert werden, und eine Auflistung mit ratenbasierte die Collect Methode. Beachten Sie, dass die Benachrichtigung nicht garantiert, dass eine vollständige Garbagecollection ausgeführt wird, nur die Bedingungen den Schwellenwert, der für eine vollständige Garbagecollection erfolgen günstig sind erreicht haben.

Sie erreichen die CancelFullGCNotification Methode, wenn das Timeout verstreichen gewartet werden kann.

Befolgen Sie diese Methode mit einem Aufruf der WaitForFullGCComplete Methode, um sicherzustellen, dass Sie eine vollständige Garbagecollection hatten. Beim Aufrufen dieser Methode allein bewirkt, dass die unbestimmte Ergebnisse.

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: