Edit

Share via


GCCollectionMode Enum

Definition

Specifies the behavior for a forced garbage collection.

C#
public enum GCCollectionMode
C#
[System.Serializable]
public enum GCCollectionMode
Inheritance
GCCollectionMode
Attributes

Fields

Name Value Description
Default 0

The default setting for this enumeration, which is currently Forced.

Forced 1

Forces the garbage collection to occur immediately.

Optimized 2

Allows the garbage collector to determine whether the current time is optimal to reclaim objects.

Aggressive 3

Requests that the garbage collector decommit as much memory as possible.

Examples

The following example forces a garbage collection for generation 2 objects with the Optimized setting.

C#
using System;

class Program
{
    static void Main(string[] args)
    {
        GC.Collect(2, GCCollectionMode.Optimized);
    }
}

Remarks

Use the GC.Collect method overload to specify the GCCollectionMode value.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

See also