GCNotificationStatus Enum

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

GC.CoreCLR.cs

Memberikan informasi tentang pendaftaran saat ini untuk pemberitahuan pengumpulan sampah lengkap berikutnya.

public enum class GCNotificationStatus

public enum GCNotificationStatus

type GCNotificationStatus = 

Public Enum GCNotificationStatus

Warisan

Object

ValueType

Enum

GCNotificationStatus

Bidang

Nama	Nilai	Deskripsi
Succeeded	0	Pemberitahuan berhasil dan pendaftaran tidak dibatalkan.
Failed	1	Pemberitahuan gagal karena alasan apa pun.
Canceled	2	Pendaftaran saat ini dibatalkan oleh pengguna.
Timeout	3	Waktu yang ditentukan oleh millisecondsTimeout parameter untuk salah satu WaitForFullGCApproach(Int32) atau WaitForFullGCComplete(Int32) telah berlalu.
NotApplicable	4	Nilai ini dapat mengakibatkan ketika tidak ada pendaftaran saat ini untuk pemberitahuan pengumpulan sampah, atau GC penuh telah terjadi tetapi dilakukan sebagai GC latar belakang (yaitu, GC yang sebagian besar berjalan bersamaan dengan utas pengguna) alih-alih GC pemblokiran penuh. GC latar belakang diaktifkan secara default; menonaktifkannya meningkatkan akurasi prediksi tetapi menimbulkan jeda GC yang lebih besar.

Contoh

Contoh berikut mendapatkan GCNotificationStatus enumerasi dari WaitForFullGCApproach metode . Jika enumerasi mengembalikan Berhasil, enumerasi memanggil metode OnFullGCApproachNotify kustom untuk melakukan tindakan sebagai respons terhadap pengumpulan sampah penuh yang mendekati. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk topik Pemberitahuan Pengumpulan Sampah .

public static void WaitForFullGCProc()
{
    while (true)
    {
        // CheckForNotify is set to true and false in Main.
        while (checkForNotify)
        {
            // Check for a notification of an approaching collection.
            GCNotificationStatus s = GC.WaitForFullGCApproach();
            if (s == GCNotificationStatus.Succeeded)
            {
                Console.WriteLine("GC Notification raised.");
                OnFullGCApproachNotify();
            }
            else if (s == GCNotificationStatus.Canceled)
            {
                Console.WriteLine("GC Notification cancelled.");
                break;
            }
            else
            {
                // This can occur if a timeout period
                // is specified for WaitForFullGCApproach(Timeout)
                // or WaitForFullGCComplete(Timeout)
                // and the time out period has elapsed.
                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;
            }
        }

        Thread.Sleep(500);
        // FinalExit is set to true right before
        // the main thread cancelled notification.
        if (finalExit)
        {
            break;
        }
    }
}

let waitForFullGCProc () =
    let mutable broken = false

    while not broken do
        let mutable broken = false
        // CheckForNotify is set to true and false in Main.
        while checkForNotify && not broken do
            // Check for a notification of an approaching collection.
            match GC.WaitForFullGCApproach() with
            | GCNotificationStatus.Succeeded ->
                printfn "GC Notification raised."
                onFullGCApproachNotify ()
                // 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
            | GCNotificationStatus.Canceled ->
                printfn "GC Notification cancelled."
                broken <- true
            | _ ->
                // This can occur if a timeout period
                // is specified for WaitForFullGCApproach(Timeout)
                // or WaitForFullGCComplete(Timeout)
                // and the time out period has elapsed.
                printfn "GC Notification not applicable."
                broken <- true

        Thread.Sleep 500
        // FinalExit is set to true right before
        // the main thread cancelled notification.
        if finalExit then broken <- true

Public Shared Sub WaitForFullGCProc()

    While True
        ' CheckForNotify is set to true and false in Main.

        While checkForNotify
            ' Check for a notification of an approaching collection.
            Dim s As GCNotificationStatus = GC.WaitForFullGCApproach
            If (s = GCNotificationStatus.Succeeded) Then
                Console.WriteLine("GC Notification raised.")
                OnFullGCApproachNotify()
            ElseIf (s = GCNotificationStatus.Canceled) Then
                Console.WriteLine("GC Notification cancelled.")
                Exit While
            Else
                ' This can occur if a timeout period
                ' is specified for WaitForFullGCApproach(Timeout) 
                ' or WaitForFullGCComplete(Timeout)  
                ' and the time out period has elapsed. 
                Console.WriteLine("GC Notification not applicable.")
                Exit While
            End If

            ' 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

        End While
        Thread.Sleep(500)
        ' FinalExit is set to true right before  
        ' the main thread cancelled notification.
        If finalExit Then
            Exit While
        End If

    End While
End Sub

Keterangan

RegisterForFullGCNotification Gunakan metode untuk mendaftar untuk pemberitahuan pengumpulan sampah penuh. Kemudian gunakan WaitForFullGCApproach metode atau WaitForFullGCComplete metode untuk mengembalikan GCNotificationStatus enumerasi yang berisi status pemberitahuan.

Lihat juga

• Pemberitahuan Pengumpulan Sampah