(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

GC.WaitForFullGCApproach-Methode (Int32)

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)

public static GCNotificationStatus WaitForFullGCApproach(
	int millisecondsTimeout
)

Parameter

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

Rückgabewert

Typ: System.GCNotificationStatus
Der Status der registrierten Garbage Collection-Benachrichtigung.

AusnahmeBedingung
ArgumentOutOfRangeException

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

Bestimmen Sie mit der von dieser Methode zurückgegebenen GCNotificationStatus-Enumeration den Status der aktuellen Garbage Collection-Benachrichtigung, die mit der RegisterForFullGCNotification-Methode registriert wurde. Sie können auch mit der WaitForFullGCComplete-Methode bestimmen, ob die vollständige Garbage Collection abgeschlossen wurde.

Beachten Sie, dass diese Methode sofort beendet wird, wenn der Garbage Collection-Benachrichtigungsstatus abgerufen wurde, unabhängig von dem mit millisecondsTimeout angegebenen Wert. Wenn vor dem Timeout von millisecondsTimeout kein Garbage Collection-Benachrichtigungsstatus abgerufen wurde, gibt diese Methode NotApplicable zurück.

Wenn die Enumeration Succeeded zurückgibt, können Sie beispielsweise verhindern, dass weitere Objekte reserviert werden, und mit der Collect-Methode selbst eine Garbage Collection auslösen. Beachten Sie, dass die Benachrichtigung nicht die Ausführung einer vollständigen Garbage Collection sicherstellt, sondern nur angibt, dass die Bedingungen den Schwellenwert erreicht haben, der die Ausführung einer vollständigen Garbage Collection begünstigt.

Sie können die CancelFullGCNotification-Methode aufrufen, wenn Sie nicht bis zum Ablauf der Timeoutspanne warten können.

Rufen Sie nach dieser Methode die WaitForFullGCComplete-Methode auf, um sicherzustellen, dass eine vollständige Garbage Collection ausgeführt wurde. Wenn nur diese Methode aufgerufen wird, sind die Ergebnisse unbestimmt.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP2, 2.0 SP2

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

  • LinkDemand 

    für volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden.

  • SecurityCriticalAttribute 

    Erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von teilweise vertrauenswürdigem oder transparentem Code nicht verwendet werden.

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft