Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

GCCollectionMode Enum

Definition

Namespace:
System
Assemblies:
mscorlib.dll, System.Runtime.dll
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs
Source:
SafeFileHandle.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Specifies the behavior for a forced garbage collection.

public enum class GCCollectionMode
public enum GCCollectionMode
[System.Serializable]
public enum GCCollectionMode
type GCCollectionMode = 
[<System.Serializable>]
type GCCollectionMode = 
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.

using System;

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

GC.Collect(2, GCCollectionMode.Optimized)
Class Program

 Public Shared Sub Main()
 GC.Collect(2, GCCollectionMode.Optimized)
 End Sub
End Class

Remarks

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

Applies to

See also


Feedback

Was this page helpful?