GC Classe

Definizione

Spazio dei nomi:: System

Assembly:: mscorlib.dll, System.Runtime.dll

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origine:: GC.cs

Origine:: GC.cs

Origine:: GC.cs

Origine:: GC.cs

Origine:: GC.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object
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

Per altre informazioni su questa API, vedere Osservazioni supplementari sulle API per GC.

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

Commenti e suggerimenti

Questa pagina è stata utile?