GC Clase

Definición

Controla el recolector de elementos no utilizados del sistema, un servicio que recupera de forma automática la memoria que no se utiliza.Controls the system garbage collector, a service that automatically reclaims unused memory.

public ref class GC abstract sealed
public static class GC
type GC = class
Public Class GC
Herencia
GC

Ejemplos

En el ejemplo siguiente se usan varios métodos GC para obtener información sobre la generación y la memoria sobre un bloque de objetos no utilizados y cómo imprimirlo en la consola.The following example uses several GC methods to get generation and memory information about a block of unused objects and print it to the console. A continuación, se recopilan los objetos no utilizados y se muestran los totales de memoria resultantes.The unused objects are then collected, and the resulting memory totals are displayed.

using namespace System;
const long maxGarbage = 1000;
ref class MyGCCollectClass
{
public:
   void MakeSomeGarbage()
   {
      Version^ vt;
      for ( int i = 0; i < maxGarbage; i++ )
      {
         
         // Create objects and release them to fill up memory
         // with unused objects.
         vt = gcnew Version;

      }
   }

};

int main()
{
   MyGCCollectClass^ myGCCol = gcnew 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 ) );
}

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();
            }
        }
    }
}
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

Comentarios

El recolector de elementos no utilizados es un componente de Common Language Runtime que controla la asignación y liberación de la memoria administrada.The garbage collector is a common language runtime component that controls the allocation and release of managed memory. Los métodos de esta clase influyen en el momento en que se realiza la recolección de elementos no utilizados en un objeto y cuando se liberan los recursos asignados por un objeto.The methods in this class influence when garbage collection is performed on an object and when resources allocated by an object are released. Las propiedades de esta clase proporcionan información sobre la cantidad total de memoria disponible en el sistema y la categoría de edad, o generación, de la memoria asignada a un objeto.Properties in this class provide information about the total amount of memory available in the system and the age category, or generation, of memory allocated to an object.

El recolector de elementos no utilizados realiza un seguimiento y recupera los objetos asignados en la memoria administrada.The garbage collector tracks and reclaims objects allocated in managed memory. Periódicamente, el recolector de elementos no utilizados realiza la recolección de elementos no utilizados para reclamar la memoria asignada a los objetos para los que no hay referencias válidas.Periodically, the garbage collector performs garbage collection to reclaim memory allocated to objects for which there are no valid references. La recolección de elementos no utilizados se produce automáticamente cuando no se puede satisfacer una solicitud de memoria con la memoria libre disponible.Garbage collection happens automatically when a request for memory cannot be satisfied using available free memory. Como alternativa, una aplicación puede forzar la recolección de elementos no utilizados con el método Collect.Alternatively, an application can force garbage collection using the Collect method.

La recolección de elementos no utilizados consta de los siguientes pasos:Garbage collection consists of the following steps:

  1. El recolector de elementos no utilizados busca objetos administrados a los que se hace referencia en código administrado.The garbage collector searches for managed objects that are referenced in managed code.

  2. El recolector de elementos no utilizados intenta finalizar los objetos a los que no se hace referencia.The garbage collector tries to finalize objects that are not referenced.

  3. El recolector de elementos no utilizados libera los objetos a los que no se hace referencia y reclama su memoria.The garbage collector frees objects that are not referenced and reclaims their memory.

En este tema, se incluyen las siguientes secciones:This topic includes the following sections:

El recolector de elementos no utilizados y los recursos no administrados The garbage collector and unmanaged resources
Antigüedad y generaciones de objetos Object aging and generations
No se permite la recolección de elementos no utilizadosDisallowing garbage collection

El recolector de elementos no utilizados y los recursos no administradosThe garbage collector and unmanaged resources

Durante una recolección, el recolector de elementos no utilizados no liberará un objeto si encuentra una o varias referencias al objeto en código administrado.During a collection, the garbage collector will not free an object if it finds one or more references to the object in managed code. Sin embargo, el recolector de elementos no utilizados no reconoce las referencias a un objeto de código no administrado y puede liberar objetos que se usan exclusivamente en código no administrado, a menos que se impida explícitamente hacerlo.However, the garbage collector does not recognize references to an object from unmanaged code, and might free objects that are being used exclusively in unmanaged code unless explicitly prevented from doing so. El método KeepAlive proporciona un mecanismo que impide que el recolector de elementos no utilizados recopile objetos que todavía se están usando en código no administrado.The KeepAlive method provides a mechanism that prevents the garbage collector from collecting objects that are still in use in unmanaged code.

Además de las asignaciones de memoria administrada, las implementaciones del recolector de elementos no utilizados no mantienen información sobre los recursos mantenidos por un objeto, como los identificadores de archivo o las conexiones de base de datos.Aside from managed memory allocations, implementations of the garbage collector do not maintain information about resources held by an object, such as file handles or database connections. Cuando un tipo usa recursos no administrados que se deben liberar antes de que se recuperen las instancias del tipo, el tipo puede implementar un finalizador.When a type uses unmanaged resources that must be released before instances of the type are reclaimed, the type can implement a finalizer.

En la mayoría de los casos, los finalizadores se implementan invalidando el método Object.Finalize; sin embargo, los tipos C# escritos C++ en o implementan destructores, que los compiladores convierten en una invalidación de Object.Finalize.In most cases, finalizers are implemented by overriding the Object.Finalize method; however, types written in C# or C++ implement destructors, which compilers turn into an override of Object.Finalize. En la mayoría de los casos, si un objeto tiene un finalizador, el recolector de elementos no utilizados lo llama antes de liberar el objeto.In most cases, if an object has a finalizer, the garbage collector calls it prior to freeing the object. Sin embargo, no es necesario que el recolector de elementos no utilizados llame a los finalizadores en todas las situaciones; por ejemplo, el método SuppressFinalize impide explícitamente que se llame al finalizador de un objeto.However, the garbage collector is not required to call finalizers in all situations; for example, the SuppressFinalize method explicitly prevents an object's finalizer from being called. Además, el recolector de elementos no utilizados no tiene que utilizar un subproceso específico para finalizar los objetos o garantizar el orden en que se llama a los finalizadores para los objetos que hacen referencia entre sí, pero que están disponibles para la recolección de elementos no utilizados.Also, the garbage collector is not required to use a specific thread to finalize objects, or guarantee the order in which finalizers are called for objects that reference each other but are otherwise available for garbage collection.

En escenarios donde los recursos deben liberarse en un momento determinado, las clases pueden implementar la interfaz IDisposable, que contiene el método IDisposable.Dispose que realiza las tareas de limpieza y administración de recursos.In scenarios where resources must be released at a specific time, classes can implement the IDisposable interface, which contains the IDisposable.Dispose method that performs resource management and cleanup tasks. Las clases que implementan Dispose deben especificar, como parte de su contrato de clase, si y cuando los consumidores de la clase llaman al método para limpiar el objeto.Classes that implement Dispose must specify, as part of their class contract, if and when class consumers call the method to clean up the object. De forma predeterminada, el recolector de elementos no utilizados no llama al método Dispose; sin embargo, las implementaciones del método Dispose pueden llamar a métodos de la clase GC para personalizar el comportamiento de finalización del recolector de elementos no utilizados.The garbage collector does not, by default, call the Dispose method; however, implementations of the Dispose method can call methods in the GC class to customize the finalization behavior of the garbage collector.

Para obtener más información sobre la finalización de objetos y el patrón de Dispose, consulte limpiar recursos no administrados.For more information on object finalization and the dispose pattern, see Cleaning Up Unmanaged Resources.

Detección y generación de objetosObject aging and generations

El recolector de elementos no utilizados en el Common Language Runtime admite la detección de objetos mediante generaciones.The garbage collector in the common language runtime supports object aging using generations. Una generación es una unidad de medida de la antigüedad relativa de los objetos en la memoria.A generation is a unit of measure of the relative age of objects in memory. El número de generación, o Age, de un objeto indica la generación a la que pertenece un objeto.The generation number, or age, of an object indicates the generation to which an object belongs. Los objetos creados más recientemente forman parte de las generaciones más recientes y tienen números de generación inferiores a los objetos creados anteriormente en el ciclo de vida de la aplicación.Objects created more recently are part of newer generations, and have lower generation numbers than objects created earlier in the application life cycle. Los objetos de la generación más reciente se encuentran en la generación 0.Objects in the most recent generation are in generation 0. Esta implementación del recolector de elementos no utilizados admite tres generaciones de objetos, las generaciones 0, 1 y 2.This implementation of the garbage collector supports three generations of objects, generations 0, 1, and 2. Puede recuperar el valor de la propiedad MaxGeneration para determinar el número de generación máximo compatible con el sistema.You can retrieve the value of the MaxGeneration property to determine the maximum generation number supported by the system.

La detección de objetos permite a las aplicaciones destinar la recolección de elementos no utilizados en un conjunto específico de generaciones en lugar de requerir que el recolector de elementos no utilizados evalúe todas las generaciones.Object aging allows applications to target garbage collection at a specific set of generations rather than requiring the garbage collector to evaluate all generations. Las sobrecargas del método Collect que incluyen un parámetro generation permiten especificar la generación más antigua para la recolección de elementos no utilizados.Overloads of the Collect method that include a generation parameter allow you to specify the oldest generation to be garbage collected.

No se permite la recolección de elementos no utilizadosDisallowing garbage collection

A partir de .NET Framework 4.6.NET Framework 4.6, el recolector de elementos no utilizados admite el modo de latencia de región no GC que se puede usar durante la ejecución de rutas de acceso críticas en las que la recolección de elementos no utilizados puede afectar negativamente al rendimiento de una aplicación.Starting with the .NET Framework 4.6.NET Framework 4.6, the garbage collector supports a no GC region latency mode that can be used during the execution of critical paths in which garbage collection can adversely affect an app's performance. El modo de no latencia de la región de GC requiere que especifique una cantidad de memoria que se puede asignar sin interferencias del recolector de elementos no utilizados.The no GC region latency mode requires that you specify an amount of memory that can be allocated without interference from the garbage collector. Si el tiempo de ejecución puede asignar esa memoria, el tiempo de ejecución no realizará una recolección de elementos no utilizados mientras se esté ejecutando el código de la ruta crítica.If the runtime can allocate that memory, the runtime will not perform a garbage collection while code in the critical path is executing.

El inicio de la ruta crítica de la región no GC no se define mediante una llamada a una de las sobrecargas del TryStartNoGCRegion.You define the beginning of the critical path of the no GC region by calling one of the overloads of the TryStartNoGCRegion. Especifique el final de la ruta crítica llamando al método EndNoGCRegion.You specify the end of its critical path by calling the EndNoGCRegion method.

No se pueden anidar llamadas al método TryStartNoGCRegion y solo se debe llamar al método EndNoGCRegion si el tiempo de ejecución no está actualmente en modo de latencia de región GC.You cannot nest calls to the TryStartNoGCRegion method, and you should only call the EndNoGCRegion method if the runtime is currently in no GC region latency mode. En otras palabras, no debe llamar a TryStartNoGCRegion varias veces (después de la primera llamada al método, las llamadas posteriores no se realizarán correctamente) y no debería esperar que las llamadas a EndNoGCRegion se realicen correctamente solo porque la primera llamada a TryStartNoGCRegion se realizó correctamente.In other words, you should not call TryStartNoGCRegion multiple times (after the first method call, subsequent calls will not succeed), and you should not expect calls to EndNoGCRegion to succeed just because the first call to TryStartNoGCRegion succeeded.

Propiedades

MaxGeneration

Obtiene el número máximo de generaciones que el sistema admite en la actualidad.Gets the maximum number of generations that the system currently supports.

Métodos

AddMemoryPressure(Int64)

Informa al tiempo de ejecución de una asignación grande de memoria no administrada que se debe tener en cuenta al programar la recolección de elementos no utilizados.Informs the runtime of a large allocation of unmanaged memory that should be taken into account when scheduling garbage collection.

CancelFullGCNotification()

Cancela el registro de una notificación de recolección de elementos no utilizados.Cancels the registration of a garbage collection notification.

Collect()

Fuerza a que se lleve a cabo una recolección de elementos no utilizados de todas las generaciones.Forces an immediate garbage collection of all generations.

Collect(Int32)

Fuerza a que se lleve a cabo inmediatamente la recolección de elementos no utilizados desde la generación 0 hasta la generación especificada.Forces an immediate garbage collection from generation 0 through a specified generation.

Collect(Int32, GCCollectionMode)

Fuerza una recolección de elementos no utilizados desde la generación 0 hasta la generación especificada, en el momento especificado por el valor GCCollectionMode.Forces a garbage collection from generation 0 through a specified generation, at a time specified by a GCCollectionMode value.

Collect(Int32, GCCollectionMode, Boolean)

Fuerza una recolección de elementos no utilizados de generación 0 en una generación especificada, en un momento especificado por un valor de GCCollectionMode, con un valor que especifica si la recolección debe ser de bloqueo.Forces a garbage collection from generation 0 through a specified generation, at a time specified by a GCCollectionMode value, with a value specifying whether the collection should be blocking.

Collect(Int32, GCCollectionMode, Boolean, Boolean)

Fuerza una recolección de elementos no utilizados de generación 0 en una generación especificada, en un momento especificado por un valor de GCCollectionMode, con valores que especifican si la recolección debe ser de bloqueo y compactante.Forces a garbage collection from generation 0 through a specified generation, at a time specified by a GCCollectionMode value, with values that specify whether the collection should be blocking and compacting.

CollectionCount(Int32)

Devuelve el número de veces que se ha producido la recolección de elementos no utilizados para la generación de objetos especificada.Returns the number of times garbage collection has occurred for the specified generation of objects.

EndNoGCRegion()

Finaliza el modo de no latencia en la región GC.Ends the no GC region latency mode.

GetAllocatedBytesForCurrentThread()

Obtiene el número total de bytes asignados al subproceso actual desde el principio de su duración.Gets the total number of bytes allocated to the current thread since the beginning of its lifetime.

GetGCMemoryInfo()

Obtiene información de la memoria de la colección de elementos no utilizados.Gets garbage collection memory information.

GetGeneration(Object)

Devuelve el número de generación actual del objeto especificado.Returns the current generation number of the specified object.

GetGeneration(WeakReference)

Devuelve el número de generación actual del destino de una referencia débil especificada.Returns the current generation number of the target of a specified weak reference.

GetTotalAllocatedBytes(Boolean)

Obtiene un recuento de los bytes asignados durante la vigencia del proceso.Gets a count of the bytes allocated over the lifetime of the process.

GetTotalMemory(Boolean)

Recupera el número de bytes que se considera que están asignados en la actualidad.Retrieves the number of bytes currently thought to be allocated. Un parámetro indica si este método puede esperar un breve intervalo de tiempo antes de regresar, para permitir que el sistema recoja los elementos no utilizados y finalice los objetos.A parameter indicates whether this method can wait a short interval before returning, to allow the system to collect garbage and finalize objects.

KeepAlive(Object)

Hace referencia al objeto especificado, convirtiéndolo en un objeto no válido para la recolección de elementos no utilizados desde el principio de la rutina actual hasta el momento en que se llamó a este método.References the specified object, which makes it ineligible for garbage collection from the start of the current routine to the point where this method is called.

RegisterForFullGCNotification(Int32, Int32)

Especifica que debe emitirse una notificación de recolección de elementos no utilizados cuando las condiciones favorecen la recolección completa de elementos no utilizados y cuando se ha completado la recolección.Specifies that a garbage collection notification should be raised when conditions favor full garbage collection and when the collection has been completed.

RemoveMemoryPressure(Int64)

Informa al tiempo de ejecución de que se ha liberado la memoria no administrada y ya no se necesita tener en cuenta al programar la recolección de elementos no utilizados.Informs the runtime that unmanaged memory has been released and no longer needs to be taken into account when scheduling garbage collection.

ReRegisterForFinalize(Object)

Solicita que el sistema llame al finalizador del objeto especificado, para el que previamente se ha llamado a SuppressFinalize(Object).Requests that the system call the finalizer for the specified object for which SuppressFinalize(Object) has previously been called.

SuppressFinalize(Object)

Solicita que Common Language Runtime no llame al finalizador del objeto especificado.Requests that the common language runtime not call the finalizer for the specified object.

TryStartNoGCRegion(Int64)

Intenta suspender la recolección de elementos durante la ejecución de una ruta crítica si una cantidad específica de memoria está disponible.Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available.

TryStartNoGCRegion(Int64, Boolean)

Intenta suspender la recolección de elementos no usados durante la ejecución de una ruta crítica si una cantidad especificada de memoria está disponible y controla si el recolector de elementos no usados realiza una recolección de elementos no usados de bloqueo completa si no hay suficiente memoria disponible inicialmente.Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available, and controls whether the garbage collector does a full blocking garbage collection if not enough memory is initially available.

TryStartNoGCRegion(Int64, Int64)

Intenta suspender la recolección de elementos no usados durante la ejecución de una ruta crítica si una cantidad específica de memoria está disponible para los montones de objetos pequeños y grandes.Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available for the large object heap and the small object heap.

TryStartNoGCRegion(Int64, Int64, Boolean)

Intenta suspender la recolección de elementos no usados durante la ejecución de una ruta crítica si una cantidad especificada de memoria está disponible para los montones de objetos grandes y pequeños, y controla si el recolector de elementos no usados realiza una recolección de elementos no usados de bloqueo completa si no hay suficiente memoria disponible inicialmente.Attempts to disallow garbage collection during the execution of a critical path if a specified amount of memory is available for the large object heap and the small object heap, and controls whether the garbage collector does a full blocking garbage collection if not enough memory is initially available.

WaitForFullGCApproach()

Devuelve el estado de una notificación registrada para determinar si es inminente una recolección completa de elementos no utilizados bloqueada por parte de Common Language Runtime.Returns the status of a registered notification for determining whether a full, blocking garbage collection by the common language runtime is imminent.

WaitForFullGCApproach(Int32)

Devuelve el estado de una notificación registrada, en un tiempo de espera especificado, para determinar si una recolección completa de elementos no utilizados bloqueada por parte de Common Language Runtime es inminente.Returns, in a specified time-out period, the status of a registered notification for determining whether a full, blocking garbage collection by the common language runtime is imminent.

WaitForFullGCComplete()

Devuelve el estado de una notificación registrada para determinar si se ha completado una recolección completa de elementos no utilizados bloqueada por parte de Common Language Runtime.Returns the status of a registered notification for determining whether a full, blocking garbage collection by the common language runtime has completed.

WaitForFullGCComplete(Int32)

Devuelve el estado de una notificación registrada, en un tiempo de espera especificado, para determinar si se ha completado una recolección completa de elementos no utilizados bloqueada por parte de Common Language Runtime.Returns, in a specified time-out period, the status of a registered notification for determining whether a full, blocking garbage collection by common language the runtime has completed.

WaitForPendingFinalizers()

Suspende el subproceso actual hasta que el subproceso que está procesando la cola de finalizadores vacíe dicha cola.Suspends the current thread until the thread that is processing the queue of finalizers has emptied that queue.

Se aplica a

Consulte también: