GC.WaitForFullGCComplete Methode

Definitie

Retourneert de status van een geregistreerde melding om te bepalen of een volledige, blokkerende garbagecollection door de algemene taalruntime is voltooid.

Overloads

Name Description
WaitForFullGCComplete()

Retourneert de status van een geregistreerde melding om te bepalen of een volledige, blokkerende garbagecollection door de algemene taalruntime is voltooid.

WaitForFullGCComplete(Int32)

Retourneert, in een opgegeven time-outperiode, de status van een geregistreerde melding om te bepalen of een volledige garbagecollection wordt geblokkeerd door algemene taal die de runtime heeft voltooid.

WaitForFullGCComplete(TimeSpan)

Retourneert de status van een geregistreerde melding over of een blokkerende garbagecollection is voltooid. Kan voor onbepaalde tijd wachten op een volledige verzameling.

WaitForFullGCComplete()

Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs

Retourneert de status van een geregistreerde melding om te bepalen of een volledige, blokkerende garbagecollection door de algemene taalruntime is voltooid.

public:
 static GCNotificationStatus WaitForFullGCComplete();
public static GCNotificationStatus WaitForFullGCComplete();
[System.Security.SecurityCritical]
public static GCNotificationStatus WaitForFullGCComplete();
static member WaitForFullGCComplete : unit -> GCNotificationStatus
[<System.Security.SecurityCritical>]
static member WaitForFullGCComplete : unit -> GCNotificationStatus
Public Shared Function WaitForFullGCComplete () As GCNotificationStatus

Retouren

De status van de geregistreerde garbagecollectionmelding.

Kenmerken

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze methode gebruikt om te bepalen of een volledige garbagecollection is voltooid. Wanneer de status van de melding is Succeeded, wordt de gebruikersmethode OnFullGCCompletedNotify aangeroepen om acties uit te voeren als reactie op de voltooide verzameling. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor het onderwerp Garbagecollection-meldingen .

// Check for a notification of a completed collection.
GCNotificationStatus status = GC.WaitForFullGCComplete();
if (status == GCNotificationStatus.Succeeded)
{
    Console.WriteLine("GC Notification raised.");
    OnFullGCCompleteEndNotify();
}
else if (status == GCNotificationStatus.Canceled)
{
    Console.WriteLine("GC Notification cancelled.");
    break;
}
else
{
    // Could be a time out.
    Console.WriteLine("GC Notification not applicable.");
    break;
}
// Check for a notification of a completed collection.
match GC.WaitForFullGCComplete() with
| GCNotificationStatus.Succeeded ->
    printfn "GC Notification raised."
    onFullGCCompleteEndNotify ()
| GCNotificationStatus.Canceled ->
    printfn "GC Notification cancelled."
    broken <- true
| _ ->
    // Could be a time out.
    printfn "GC Notification not applicable."
    broken <- true
' Check for a notification of a completed collection.
s = GC.WaitForFullGCComplete
If (s = GCNotificationStatus.Succeeded) Then
    Console.WriteLine("GC Notifiction raised.")
    OnFullGCCompleteEndNotify()
ElseIf (s = GCNotificationStatus.Canceled) Then
    Console.WriteLine("GC Notification cancelled.")
    Exit While
Else
    ' Could be a time out.
    Console.WriteLine("GC Notification not applicable.")
    Exit While
End If

Opmerkingen

Gebruik de GCNotificationStatus opsomming die door deze methode wordt geretourneerd om de status te bepalen van de huidige garbagecollectionmelding die is geregistreerd met behulp van de RegisterForFullGCNotification methode. U kunt ook de WaitForFullGCApproach methode gebruiken om te bepalen of een volledige garbagecollection op komst is.

Wanneer de inventarisatie wordt geretourneerd Succeeded, kunt u taken uitvoeren zoals het hervatten van werk en het verkrijgen van een verzamelingsaantal met de CollectionCount(Int32) methode.

Deze methode wacht voor onbepaalde tijd totdat een garbagecollectionmelding is verkregen. Als u een time-outperiode wilt opgeven voor de methode die moet worden geretourneerd als de melding niet kan worden verkregen, gebruikt u de overbelasting van de GC.WaitForFullGCApproach(Int32) methode. Als u deze methode aanroept zonder een time-out op te geven, kunt u de CancelFullGCNotification methode aanroepen als u langer wacht dan gewenst.

Deze methode-aanroep moet worden voorafgegaan door een aanroep naar de WaitForFullGCApproach methode om ervoor te zorgen dat u een volledige garbagecollection hebt gehad. Het aanroepen van deze methode alleen kan onbepaalde resultaten opleveren.

Zie ook

Van toepassing op

WaitForFullGCComplete(Int32)

Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs
Bron:
GC.CoreCLR.cs

Retourneert, in een opgegeven time-outperiode, de status van een geregistreerde melding om te bepalen of een volledige garbagecollection wordt geblokkeerd door algemene taal die de runtime heeft voltooid.

public:
 static GCNotificationStatus WaitForFullGCComplete(int millisecondsTimeout);
public static GCNotificationStatus WaitForFullGCComplete(int millisecondsTimeout);
[System.Security.SecurityCritical]
public static GCNotificationStatus WaitForFullGCComplete(int millisecondsTimeout);
static member WaitForFullGCComplete : int -> GCNotificationStatus
[<System.Security.SecurityCritical>]
static member WaitForFullGCComplete : int -> GCNotificationStatus
Public Shared Function WaitForFullGCComplete (millisecondsTimeout As Integer) As GCNotificationStatus

Parameters

millisecondsTimeout
Int32

De tijdsduur die moet worden gewacht voordat een meldingsstatus kan worden verkregen. Geef -1 op om voor onbepaalde tijd te wachten.

Retouren

De status van de geregistreerde garbagecollectionmelding.

Kenmerken

Uitzonderingen

millisecondsTimeout moet niet-negatief of kleiner zijn dan of gelijk zijn aan Int32.MaxValue of -1.

Opmerkingen

Gebruik de GCNotificationStatus opsomming die door deze methode wordt geretourneerd om de status te bepalen van de huidige garbagecollectionmelding die is geregistreerd met behulp van de RegisterForFullGCNotification methode. U kunt ook de WaitForFullGCApproach methode gebruiken om te bepalen of een volledige garbagecollection op komst is.

Houd er rekening mee dat deze methode onmiddellijk wordt geretourneerd wanneer de status van een garbagecollectionmelding wordt verkregen, ongeacht de waarde die is opgegeven door millisecondsTimeout. Als er geen meldingsstatus voor garbagecollection wordt verkregen voordat millisecondsTimeout er een time-out optreedt, retourneert NotApplicabledeze methode.

Wanneer de inventarisatie wordt geretourneerd Succeeded, kunt u taken uitvoeren zoals het hervatten van het werk en het verkrijgen van een verzamelingsaantal met de CollectionCount(Int32) eigenschap.

U kunt de CancelFullGCNotification methode aanroepen wanneer u niet kunt wachten tot de time-outperiode is verstreken.

Deze methode-aanroep moet worden voorafgegaan door een aanroep naar de WaitForFullGCApproach methode om ervoor te zorgen dat u een volledige garbagecollection hebt gehad. Het aanroepen van deze methode alleen kan onbepaalde resultaten opleveren.

Zie ook

Van toepassing op

WaitForFullGCComplete(TimeSpan)

Bron:
GC.cs
Bron:
GC.cs
Bron:
GC.cs
Bron:
GC.cs
Bron:
GC.cs

Retourneert de status van een geregistreerde melding over of een blokkerende garbagecollection is voltooid. Kan voor onbepaalde tijd wachten op een volledige verzameling.

public:
 static GCNotificationStatus WaitForFullGCComplete(TimeSpan timeout);
public static GCNotificationStatus WaitForFullGCComplete(TimeSpan timeout);
static member WaitForFullGCComplete : TimeSpan -> GCNotificationStatus
Public Shared Function WaitForFullGCComplete (timeout As TimeSpan) As GCNotificationStatus

Parameters

timeout
TimeSpan

De time-out bij het wachten op een volledige verzameling

Retouren

De status van een geregistreerde volledige GC-melding

Van toepassing op