GCSettings.IsServerGC Property

Gets a value that indicates whether server garbage collection is enabled.

Namespace:  System.Runtime
Assemblies:   System.Runtime (in System.Runtime.dll)
  mscorlib (in mscorlib.dll)

public static bool IsServerGC { get; }

Property Value

Type: System.Boolean
true if server garbage collection is enabled; otherwise, false.

For information about server garbage collection, see the "Workstation and Server Garbage Collection" section in Fundamentals of Garbage Collection.

If server garbage collection is not enabled, workstation garbage collection is in effect (with or without concurrent collection). Server garbage collection is available only on multiprocessor computers.

An unmanaged host can request server garbage collection, and the host request overrides configuration file settings. If the host does not specify the type of garbage collection, you can use a configuration file setting to specify server garbage collection. This setting is valid only in the application configuration file, not in the machine configuration file (see Configuring Apps by using Configuration Files). The following example shows the contents of a sample application configuration file that enables server garbage collection.

<configuration>
  <runtime>
    <gcServer enabled="true" />
  </runtime>
</configuration>

The following example indicates whether the host computer is using server or workstation garbage collection.

using System;
using System.Runtime;

class Sample 
{
    public static void Main() 
    {
    string result;

    if (GCSettings.IsServerGC == true)
        result = "server";
    else 
        result = "workstation";
    Console.WriteLine("The {0} garbage collector is running.", result);
    }
}
// The example displays output like the following: 
//      The workstation garbage collector is running.

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft