GC.WaitForFullGCComplete Metodo

Origine:

GC.CoreCLR.cs

Origine:

GC.CoreCLR.cs

Origine:

GC.CoreCLR.cs

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

Restituisce

Stato della notifica dell'operazione di Garbage Collection registrata.

Attributi

SecurityCriticalAttribute

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo per determinare se è stata completata un'operazione completa di Garbage Collection. Ogni volta che lo stato della notifica è Succeeded, viene chiamato il metodo OnFullGCCompletedNotify utente per eseguire azioni in risposta alla raccolta completata. Questo esempio di codice fa parte di un esempio più ampio fornito per l'argomento Notifiche di Garbage Collection .

// Check for a notification of a completed collection.
s = GC::WaitForFullGCComplete();
if (s == GCNotificationStatus::Succeeded)
{
    Console::WriteLine("GC Notification 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;
}

// 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

Commenti

Usare l'enumerazione GCNotificationStatus restituita da questo metodo per determinare lo stato della notifica di Garbage Collection corrente registrata tramite il RegisterForFullGCNotification metodo . È anche possibile usare il WaitForFullGCApproach metodo per determinare se un'operazione di Garbage Collection completa è imminente.

Quando l'enumerazione restituisce Succeeded, è possibile eseguire attività come riprendere il lavoro e ottenere un conteggio di raccolte con la CollectionCount proprietà .

Questo metodo attende per un periodo illimitato che venga ottenuta una notifica di Garbage Collection. Se si desidera specificare un periodo di timeout per il metodo da restituire se non è possibile ottenere la notifica, utilizzare l'overload del GC.WaitForFullGCApproach(Int32) metodo. Se si chiama questo metodo senza specificare un timeout, è possibile chiamare il CancelFullGCNotification metodo se si è in attesa più lungo del preferito.

Questa chiamata al metodo deve essere preceduta da una chiamata al WaitForFullGCApproach metodo per assicurarsi di disporre di un'operazione di Garbage Collection completa. La chiamata di questo metodo da solo può produrre risultati indeterminato.

Vedi anche

• Notifiche di Garbage Collection

Origine:

GC.CoreCLR.cs

Origine:

GC.CoreCLR.cs

Origine:

GC.CoreCLR.cs

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

Parametri

Restituisce

Stato della notifica dell'operazione di Garbage Collection registrata.

Attributi

SecurityCriticalAttribute

Eccezioni

Commenti

Usare l'enumerazione GCNotificationStatus restituita da questo metodo per determinare lo stato della notifica di Garbage Collection corrente registrata tramite il RegisterForFullGCNotification metodo . È anche possibile usare il WaitForFullGCApproach metodo per determinare se un'operazione di Garbage Collection completa è imminente.

Si noti che questo metodo restituisce immediatamente ogni volta che viene ottenuto uno stato di notifica di Garbage Collection, indipendentemente dal valore specificato da millisecondsTimeout. Se uno stato di notifica di Garbage Collection non viene ottenuto prima millisecondsTimeout del timeout, questo metodo restituisce NotApplicable.

Quando l'enumerazione restituisce Succeeded, è possibile eseguire attività come riprendere il lavoro e ottenere un conteggio di raccolte con la CollectionCount proprietà .

È possibile chiamare il CancelFullGCNotification metodo quando non è possibile attendere la scadenza del periodo di timeout.

Questa chiamata al metodo deve essere preceduta da una chiamata al WaitForFullGCApproach metodo per assicurarsi di disporre di un'operazione di Garbage Collection completa. La chiamata di questo metodo da solo può produrre risultati indeterminato.

Vedi anche

• Notifiche di Garbage Collection

Origine:

GC.cs

Origine:

GC.cs

Origine:

GC.cs

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

Parametri

Restituisce

Stato di una notifica GC completa registrata