GC Classe

Definizione

Controlla il Garbage Collector di sistema, un servizio che recupera automaticamente la memoria inutilizzata.

public ref class GC abstract sealed
public ref class GC sealed
public static class GC
public sealed class GC
type GC = class
Public Class GC
Public NotInheritable Class GC
Ereditarietà
GC

Esempio

Nell'esempio seguente vengono utilizzati diversi metodi GC per ottenere informazioni di generazione e memoria su un blocco di oggetti inutilizzati e stamparlo nella console. Gli oggetti inutilizzati vengono quindi raccolti e vengono visualizzati i totali di memoria risultanti.

using System;

namespace GCCollectIntExample
{
    class MyGCCollectClass
    {
        private const long maxGarbage = 1000;

        static void Main()
        {
            MyGCCollectClass myGCCol = new MyGCCollectClass();

            // Determine the maximum number of generations the system
        // garbage collector currently supports.
            Console.WriteLine("The highest generation is {0}", GC.MaxGeneration);

            myGCCol.MakeSomeGarbage();

            // Determine which generation myGCCol object is stored in.
            Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol));

            // Determine the best available approximation of the number
        // of bytes currently allocated in managed memory.
            Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));

            // Perform a collection of generation 0 only.
            GC.Collect(0);

            // Determine which generation myGCCol object is stored in.
            Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol));

            Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));

            // Perform a collection of all generations up to and including 2.
            GC.Collect(2);

            // Determine which generation myGCCol object is stored in.
            Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol));
            Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));
            Console.Read();
        }

        void MakeSomeGarbage()
        {
            Version vt;

            for(int i = 0; i < maxGarbage; i++)
            {
                // Create objects and release them to fill up memory
        // with unused objects.
                vt = new Version();
            }
        }
    }
}
open System

let maxGarbage = 1000

type MyGCCollectClass() =
    member _.MakeSomeGarbage() =
        for _ = 1 to maxGarbage do
            // Create objects and release them to fill up memory with unused objects.
            Version() |> ignore

[<EntryPoint>]
let main _ =
    let myGCCol = MyGCCollectClass()

    // Determine the maximum number of generations the system
    // garbage collector currently supports.
    printfn $"The highest generation is {GC.MaxGeneration}"

    myGCCol.MakeSomeGarbage()

    // Determine which generation myGCCol object is stored in.
    printfn $"Generation: {GC.GetGeneration myGCCol}"

    // Determine the best available approximation of the number
    // of bytes currently allocated in managed memory.
    printfn $"Total Memory: {GC.GetTotalMemory false}"

    // Perform a collection of generation 0 only.
    GC.Collect 0

    // Determine which generation myGCCol object is stored in.
    printfn $"Generation: {GC.GetGeneration myGCCol}"

    printfn $"Total Memory: {GC.GetTotalMemory false}"

    // Perform a collection of all generations up to and including 2.
    GC.Collect 2

    // Determine which generation myGCCol object is stored in.
    printfn $"Generation: {GC.GetGeneration myGCCol}"
    printfn $"Total Memory: {GC.GetTotalMemory false}"

    0
Namespace GCCollectInt_Example
    Class MyGCCollectClass
        Private maxGarbage As Long = 10000

        Public Shared Sub Main()
            Dim myGCCol As New MyGCCollectClass

            'Determine the maximum number of generations the system
            'garbage collector currently supports.
            Console.WriteLine("The highest generation is {0}", GC.MaxGeneration)

            myGCCol.MakeSomeGarbage()

            'Determine which generation myGCCol object is stored in.
            Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol))

            'Determine the best available approximation of the number 
            'of bytes currently allocated in managed memory.
            Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(False))

            'Perform a collection of generation 0 only.
            GC.Collect(0)

            'Determine which generation myGCCol object is stored in.
            Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol))

            Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(False))

            'Perform a collection of all generations up to and including 2.
            GC.Collect(2)

            'Determine which generation myGCCol object is stored in.
            Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol))
            Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(False))
            Console.Read()

        End Sub


        Sub MakeSomeGarbage()
            Dim vt As Version

            Dim i As Integer
            For i = 0 To maxGarbage - 1
                'Create objects and release them to fill up memory
                'with unused objects.
                vt = New Version
            Next i
        End Sub
    End Class
End Namespace

Commenti

La GC classe controlla il Garbage Collector. Il Garbage Collector è un componente Common Language Runtime che controlla l'allocazione e il rilascio della memoria gestita. I metodi in questa classe determinano quando viene eseguita la Garbage Collection su un oggetto e quando vengono rilasciate le risorse allocate da un oggetto. Le proprietà di questa classe forniscono informazioni sulla quantità totale di memoria disponibile nel sistema e sulla categoria di età, o generazione, della memoria allocata a un oggetto .

Il garbage collector traccia e recupera gli oggetti allocati nella memoria gestita. Periodicamente, Il Garbage Collector esegue l'operazione di Garbage Collection per recuperare la memoria allocata agli oggetti per i quali non sono presenti riferimenti validi. La Garbage Collection viene eseguita automaticamente quando una richiesta di memoria non può essere soddisfatta usando la memoria disponibile. In alternativa, un'applicazione può forzare l'operazione di garbage collection usando il metodo Collect.

La raccolta dei rifiuti si compone dei seguenti passaggi:

  1. Il Garbage Collector cerca gli oggetti gestiti a cui viene fatto riferimento nel codice gestito.
  2. Il Garbage Collector tenta di finalizzare gli oggetti a cui non viene fatto riferimento.
  3. Il Garbage Collector libera gli oggetti a cui non viene fatto riferimento e ne recupera la memoria.

Risorse non gestite

Durante una raccolta, Il Garbage Collector non libera un oggetto se trova uno o più riferimenti all'oggetto nel codice gestito. Tuttavia, Il Garbage Collector non riconosce i riferimenti a un oggetto da codice non gestito e potrebbe liberare oggetti usati esclusivamente nel codice non gestito, a meno che non sia esplicitamente impedito di farlo. Il KeepAlive metodo fornisce un meccanismo che impedisce al Garbage Collector di raccogliere oggetti ancora in uso nel codice non gestito.

Oltre alle allocazioni di memoria gestita, le implementazioni di Garbage Collector non mantengono informazioni sulle risorse contenute in un oggetto, ad esempio handle di file o connessioni di database. Quando un tipo usa risorse non gestite che devono essere rilasciate prima che vengano recuperate istanze del tipo, il tipo può implementare un finalizzatore.

Nella maggior parte dei casi, i finalizzatori vengono implementati sovrascrivendo il metodo Object.Finalize. Tuttavia, i tipi scritti in C# o C++ implementano distruttori, che i compilatori trasformano in una sovrascrittura di Object.Finalize. Nella maggior parte dei casi, se un oggetto dispone di un finalizzatore, il Garbage Collector lo chiama prima di liberare l'oggetto. Tuttavia, il garbage collector non è tenuto a chiamare i finalizzatori in tutte le situazioni; ad esempio, il metodo SuppressFinalize impedisce esplicitamente di chiamare il finalizzatore di un oggetto. Inoltre, il garbage collector non deve utilizzare un thread specifico per finalizzare gli oggetti, né garantire l'ordine in cui i finalizzatori vengono chiamati per gli oggetti che si riferiscono a vicenda, ma che sono altrimenti disponibili per la garbage collection.

Negli scenari in cui le risorse devono essere rilasciate in un momento specifico, le classi possono implementare l'interfaccia IDisposable , che contiene il IDisposable.Dispose metodo che esegue attività di gestione delle risorse e pulizia. Le classi che implementano Dispose devono specificare, come parte del contratto di classe, se e quando gli utenti della classe chiamano il metodo per liberare l'oggetto. Per impostazione predefinita, il Garbage Collector non chiama il Dispose metodo. Tuttavia, le implementazioni del Dispose metodo possono chiamare metodi nella GC classe per personalizzare il comportamento di finalizzazione del Garbage Collector.

Per altre informazioni sulla finalizzazione degli oggetti e sul modello dispose, vedere Pulizia delle risorse non gestite.

Invecchiamento degli oggetti e generazioni

Il garbage collector nel Common Language Runtime supporta l'invecchiamento degli oggetti usando le generazioni. Una generazione è un'unità di misura dell'età relativa degli oggetti in memoria. Il numero di generazione, o età, di un oggetto indica la generazione a cui appartiene un oggetto. Gli oggetti creati più di recente fanno parte delle generazioni più recenti e hanno numeri di generazione inferiori rispetto agli oggetti creati in precedenza nel ciclo di vita dell'applicazione. Gli oggetti nella generazione più recente sono nella generazione 0. Questa implementazione di Garbage Collector supporta tre generazioni di oggetti, generazioni 0, 1 e 2. È possibile recuperare il valore della MaxGeneration proprietà per determinare il numero di generazione massimo supportato dal sistema.

L'invecchiamento degli oggetti consente alle applicazioni di destinare la raccolta dei rifiuti a un insieme specifico di generazioni anziché richiedere al garbage collector di valutare tutte le generazioni. Gli overload del metodo Collect che includono un parametro generation consentono di specificare la generazione più vecchia da sottoporre a raccolta di rifiuti.

Non consentire l'operazione di Garbage Collection

Il garbage collector supporta una modalità di latenza senza GC che può essere usata durante l'esecuzione di percorsi critici in cui la garbage collection può influenzare negativamente le prestazioni di un'app. La modalità di latenza senza GC richiede che tu specifichi una quantità di memoria che può essere allocata senza interferenze da parte del garbage collector. Se il runtime può allocare tale memoria, il runtime non eseguirà un'operazione di Garbage Collection mentre il codice nel percorso critico è in esecuzione.

È possibile definire l'inizio del percorso critico dell'area non GC chiamando uno degli overload di TryStartNoGCRegion. Specificare la fine del percorso critico chiamando il EndNoGCRegion metodo .

Non è possibile annidare le chiamate al metodo TryStartNoGCRegion, e dovresti chiamare il metodo EndNoGCRegion solo se il runtime è attualmente in modalità di latenza della regione senza GC. In altre parole, non è consigliabile chiamare TryStartNoGCRegion più volte (dopo la prima chiamata al metodo, le chiamate successive non avranno esito positivo) e non ci si dovrebbe aspettare che le chiamate EndNoGCRegion abbiano esito positivo solo perché la prima chiamata a TryStartNoGCRegion ha avuto esito positivo.

Proprietà

Nome Descrizione
MaxGeneration

Ottiene il numero massimo di generazioni attualmente supportate dal sistema.

Metodi

Nome Descrizione
AddMemoryPressure(Int64)

Informa il runtime di un'allocazione elevata di memoria non gestita che deve essere presa in considerazione durante la pianificazione di Garbage Collection.

AllocateArray<T>(Int32, Boolean)

Alloca una matrice.

AllocateUninitializedArray<T>(Int32, Boolean)

Alloca una matrice ignorando l'inizializzazione zero, se possibile.

CancelFullGCNotification()

Annulla la registrazione di una notifica di Garbage Collection.

Collect()

Forza un'operazione immediata di Garbage Collection di tutte le generazioni.

Collect(Int32, GCCollectionMode, Boolean, Boolean)

Forza un'operazione di Garbage Collection dalla generazione 0 a una generazione specificata, alla volta specificata da un GCCollectionMode valore, con valori che specificano se la raccolta deve essere bloccata e compattata.

Collect(Int32, GCCollectionMode, Boolean)

Forza un'operazione di Garbage Collection dalla generazione 0 a una generazione specificata, alla volta specificata da un GCCollectionMode valore, con un valore che specifica se la raccolta deve essere bloccata.

Collect(Int32, GCCollectionMode)

Forza un'operazione di Garbage Collection dalla generazione 0 a una generazione specificata, alla volta specificata da un GCCollectionMode valore.

Collect(Int32)

Forza un'operazione immediata di Garbage Collection dalla generazione 0 a una generazione specificata.

CollectionCount(Int32)

Restituisce il numero di volte in cui si è verificata l'operazione di Garbage Collection per la generazione specificata di oggetti.

EndNoGCRegion()

Termina la modalità di latenza dell'area GC.

GetAllocatedBytesForCurrentThread()

Ottiene il numero totale di byte allocati al thread corrente dall'inizio della durata.

GetConfigurationVariables()

Ottiene le configurazioni utilizzate dal Garbage Collector.

GetGCMemoryInfo()

Ottiene informazioni sulla memoria di Garbage Collection.

GetGCMemoryInfo(GCKind)

Ottiene informazioni sulla memoria di Garbage Collection.

GetGeneration(Object)

Restituisce il numero di generazione corrente dell'oggetto specificato.

GetGeneration(WeakReference)

Restituisce il numero di generazione corrente della destinazione di un riferimento debole specificato.

GetTotalAllocatedBytes(Boolean)

Ottiene un conteggio dei byte allocati per tutta la durata del processo. Il valore restituito non include allocazioni native.

GetTotalMemory(Boolean)

Recupera le dimensioni dell'heap escluse la frammentazione. Ad esempio, se la dimensione totale dell'heap GC è di 100 mb e la frammentazione, ad esempio, lo spazio occupato da oggetti liberi, richiede 40 mb, l'API segnala 60 mb. Un parametro indica se questo metodo può attendere un breve intervallo prima della restituzione, per consentire al sistema di raccogliere i garbage e finalizzare gli oggetti.

GetTotalPauseDuration()

Ottiene la quantità totale di tempo sospesa in GC dall'inizio del processo.

KeepAlive(Object)

Fa riferimento all'oggetto specificato, che lo rende non idoneo per l'operazione di Garbage Collection dall'inizio della routine corrente al punto in cui viene chiamato questo metodo.

RefreshMemoryLimit()

Indica al Garbage Collector di riconfigurarsi rilevando i vari limiti di memoria nel sistema.

RegisterForFullGCNotification(Int32, Int32)

Specifica che deve essere generata una notifica di Garbage Collection quando le condizioni favoriscono l'operazione completa di Garbage Collection e quando la raccolta è stata completata.

RegisterNoGCRegionCallback(Int64, Action)

Registra un callback da richiamare quando una determinata quantità di memoria viene allocata nell'area non GC.

RemoveMemoryPressure(Int64)

Informa il runtime che la memoria non gestita è stata rilasciata e non deve più essere presa in considerazione durante la pianificazione di Garbage Collection.

ReRegisterForFinalize(Object)

Richiede che il sistema chiami il finalizzatore per l'oggetto specificato per il quale SuppressFinalize(Object) è stato chiamato in precedenza.

SuppressFinalize(Object)

Richiede che Common Language Runtime non chiami il finalizzatore per l'oggetto specificato.

TryStartNoGCRegion(Int64, Boolean)

Tenta di impedire l'operazione di Garbage Collection durante l'esecuzione di un percorso critico se è disponibile una quantità specificata di memoria e controlla se il Garbage Collector esegue un'operazione completa di Garbage Collection bloccando se inizialmente non è disponibile memoria sufficiente.

TryStartNoGCRegion(Int64, Int64, Boolean)

Tenta di impedire l'operazione di Garbage Collection durante l'esecuzione di un percorso critico se è disponibile una quantità specificata di memoria per l'heap di oggetti di grandi dimensioni e l'heap di oggetti di piccole dimensioni e controlla se il Garbage Collector esegue un'operazione completa di Garbage Collection bloccando se inizialmente non è disponibile memoria sufficiente.

TryStartNoGCRegion(Int64, Int64)

Tenta di impedire l'operazione di Garbage Collection durante l'esecuzione di un percorso critico se è disponibile una quantità specificata di memoria per l'heap di oggetti di grandi dimensioni e l'heap di oggetti di piccole dimensioni.

TryStartNoGCRegion(Int64)

Tenta di impedire l'operazione di Garbage Collection durante l'esecuzione di un percorso critico se è disponibile una quantità di memoria specificata.

WaitForFullGCApproach()

Restituisce lo stato di una notifica registrata per determinare se un'operazione completa di Garbage Collection bloccata da Common Language Runtime è imminente.

WaitForFullGCApproach(Int32)

Restituisce, in un periodo di timeout specificato, lo stato di una notifica registrata per determinare se un'operazione di Garbage Collection completa e bloccata da Common Language Runtime è imminente.

WaitForFullGCApproach(TimeSpan)

Restituisce, in un periodo di timeout specificato, lo stato di una notifica registrata per determinare se un'operazione di Garbage Collection completa e bloccata da Common Language Runtime è imminente.

WaitForFullGCComplete()

Restituisce lo stato di una notifica registrata per determinare se un'operazione di Garbage Collection completa e bloccata da Common Language Runtime è stata completata.

WaitForFullGCComplete(Int32)

Restituisce, in un periodo di timeout specificato, lo stato di una notifica registrata per determinare se un'operazione di Garbage Collection completa e bloccata da Common Language è stata completata.

WaitForFullGCComplete(TimeSpan)

Restituisce lo stato di una notifica registrata relativa al completamento di un'operazione di Garbage Collection di blocco. Può attendere per un periodo illimitato per una raccolta completa.

WaitForPendingFinalizers()

Sospende il thread corrente fino a quando il thread che elabora la coda di finalizzatori ha svuotato tale coda.

Si applica a

Vedi anche