GC.Collect 메서드

정의

가비지 컬렉션을 수행하도록 합니다.

오버로드

Collect()

모든 세대의 가비지 컬렉션을 즉시 수행합니다.

Collect(Int32)

0세대에서 지정된 세대까지 가비지 수집을 즉시 수행합니다.

Collect(Int32, GCCollectionMode)

GCCollectionMode 값에 지정된 시간에 0세대에서 지정된 세대까지 가비지 컬렉션을 수행합니다.

Collect(Int32, GCCollectionMode, Boolean)

수집이 차단되어야 할지 여부를 지정하는 값을 사용하여 GCCollectionMode 값으로 지정된 시간에 0세대에서 지정된 세대까지 가비지 수집을 강제로 실행합니다.

Collect(Int32, GCCollectionMode, Boolean, Boolean)

컬렉션이 차단되고 압축되어야 할지 여부를 지정하는 값을 사용하여 GCCollectionMode 값으로 지정된 시간에 0세대에서 지정된 세대까지 가비지 컬렉션을 강제로 실행합니다.

Collect()

Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs

모든 세대의 가비지 컬렉션을 즉시 수행합니다.

public static void Collect ();

예제

다음 예제에서는 메서드를 사용 하 여 Collect 모든 세대의 메모리에서 컬렉션을 수행 하는 방법을 보여 줍니다. 이 코드는 사용되지 않는 여러 개체를 생성한 다음 메서드를 Collect 호출하여 메모리에서 클린.

using System;

class MyGCCollectClass
{
   private const int maxGarbage = 1000;

   static void Main()
   {
      // Put some objects in memory.
      MyGCCollectClass.MakeSomeGarbage();
      Console.WriteLine("Memory used before collection:       {0:N0}",
                        GC.GetTotalMemory(false));

      // Collect all generations of memory.
      GC.Collect();
      Console.WriteLine("Memory used after full collection:   {0:N0}",
                        GC.GetTotalMemory(true));
   }

   static void MakeSomeGarbage()
   {
      Version vt;

      // Create objects and release them to fill up memory with unused objects.
      for(int i = 0; i < maxGarbage; i++) {
         vt = new Version();
      }
   }
}
// The output from the example resembles the following:
//       Memory used before collection:       79,392
//       Memory used after full collection:   52,640

설명

이 메서드를 사용하여 액세스할 수 없는 모든 메모리를 회수합니다. 모든 세대의 차단 가비지 수집을 수행합니다.

메모리에 있는 기간에 관계없이 모든 개체는 컬렉션으로 간주됩니다. 그러나 관리 코드에서 참조되는 개체는 수집되지 않습니다. 이 메서드를 사용하여 시스템에서 사용 가능한 최대 메모리 양을 회수하도록 강제합니다.

.NET Framework 4.5.1부터 다음 예제와 같이 메서드를 호출 Collect 하기 전에 속성을 로 설정 GCSettings.LargeObjectHeapCompactionMode 하여 LOH(큰 개체 힙)를 압축할 GCLargeObjectHeapCompactionMode.CompactOnce 수 있습니다.

GCSettings.LargeObjectHeapCompactionMode = GCLargeObjectHeapCompactionMode.CompactOnce;
GC.Collect();

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.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 1.1, 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

Collect(Int32)

Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs

0세대에서 지정된 세대까지 가비지 수집을 즉시 수행합니다.

public static void Collect (int generation);

매개 변수

generation
Int32

가비지를 수집할 가장 오래된 세대의 수입니다.

예외

generation가 잘못된 경우

예제

다음 예제에서는 사용 하는 방법을 보여 줍니다는 메모리의 Collect 개별 계층에서 컬렉션을 수행 하는 방법입니다. 이 코드는 사용되지 않는 여러 개체를 생성한 다음 메서드를 Collect 호출하여 메모리에서 클린.

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

설명

이 메서드를 사용하여 액세스할 수 없는 메모리를 회수합니다. 그러나 이 메서드를 사용하면 지정된 세대에서 액세스할 수 없는 메모리가 모두 회수되는 것은 아닙니다.

개체 에이징이 구현된 경우 가비지 수집기는 지정된 세대보다 높은 세대 번호를 가진 개체를 수집하지 않습니다. 개체 에이징이 구현되지 않은 경우 가비지 수집기는 가비지 수집 중에 모든 개체를 고려합니다.

사용 된 MaxGeneration 매개 변수의 최대 유효한 값을 generation 확인 하려면 속성입니다.

가비지 수집기에서 생성에 관계없이 모든 개체를 고려하도록 하려면 매개 변수를 사용하지 않는 이 메서드의 버전을 사용합니다. 가비지 수집기가 설정에 따라 개체를 GCCollectionMode 회수하도록 하려면 메서드 오버로드를 GC.Collect(Int32, GCCollectionMode) 사용합니다.

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.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 1.1, 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

Collect(Int32, GCCollectionMode)

Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs

GCCollectionMode 값에 지정된 시간에 0세대에서 지정된 세대까지 가비지 컬렉션을 수행합니다.

public static void Collect (int generation, GCCollectionMode mode);

매개 변수

generation
Int32

가비지를 수집할 가장 오래된 세대의 수입니다.

mode
GCCollectionMode

이 가비지의 수집 강제 (Default 또는 Forced) 또는 최적화 (Optimized) 여부를 지정하는 열거형 값입니다.

예외

generation가 잘못된 경우

또는

modeGCCollectionMode 값 중 하나가 아닌 경우

예제

다음 예제에서는 설정을 사용하여 2세대 개체에 대한 가비지 수집을 강제합니다 Optimized .

using System;

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

설명

매개 변수를 mode 사용하여 가비지 수집이 즉시 발생해야 하는지 아니면 시간이 개체를 회수하는 데 최적의 경우에만 발생해야 하는지를 지정합니다. 이 메서드를 사용하면 지정된 세대의 모든 액세스할 수 없는 메모리가 회수되는 것을 보장할 수 없습니다.

애플리케이션에서 중요 한 기간 동안 가비지 수집의 실행 시기를 조정 하려면 설정의 LatencyMode 속성입니다.

가비지 수집기는 생성 번호가 매개 변수에 지정된 것보다 높은 개체를 generation 수집하지 않습니다. 사용 된 MaxGeneration 최대 유효한 값을 확인 하려면 속성입니다 generation.

가비지 수집기에서 생성에 관계없이 모든 개체를 고려하도록 하려면 매개 변수를 사용하지 않는 이 메서드의 버전을 사용합니다.

가비지 수집기가 지정된 세대의 개체까지 개체를 회수하도록 하려면 메서드 오버로드를 GC.Collect(Int32) 사용합니다. 최대 생성을 지정하면 모든 개체가 수집됩니다.

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.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

Collect(Int32, GCCollectionMode, Boolean)

Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs

수집이 차단되어야 할지 여부를 지정하는 값을 사용하여 GCCollectionMode 값으로 지정된 시간에 0세대에서 지정된 세대까지 가비지 수집을 강제로 실행합니다.

public static void Collect (int generation, GCCollectionMode mode, bool blocking);

매개 변수

generation
Int32

가비지를 수집할 가장 오래된 세대의 수입니다.

mode
GCCollectionMode

이 가비지의 수집 강제 (Default 또는 Forced) 또는 최적화 (Optimized) 여부를 지정하는 열거형 값입니다.

blocking
Boolean

차단 가비지 수집을 수행하려면 true이고, 가능한 경우 백그라운드 가비지 수집을 수행하려면 false입니다.

예외

generation가 잘못된 경우

또는

modeGCCollectionMode 값 중 하나가 아닌 경우

설명

다음 표에는 및 blocking 매개 변수의 상호 작용이 mode 요약되어 있습니다.

mode blockingtrue인 경우 blockingfalse인 경우
Forced 또는 Default 차단 컬렉션은 가능한 한 빨리 수행됩니다. 백그라운드 컬렉션이 진행 중이고 generation 가 0 또는 1이면 메서드는 Collect(Int32, GCCollectionMode, Boolean) 즉시 차단 컬렉션을 트리거하고 컬렉션이 완료되면 를 반환합니다. 백그라운드 컬렉션이 진행 중이고 generation 가 2이면 메서드는 백그라운드 컬렉션이 완료될 때까지 기다렸다가 차단 세대 2 컬렉션을 트리거한 다음 를 반환합니다. 컬렉션은 가능한 한 빨리 수행됩니다. Collect(Int32, GCCollectionMode, Boolean) 메서드는 백그라운드 컬렉션을 요청하지만 이 작업이 항상 수행되지는 않으며 상황에 따라 차단 컬렉션이 계속 수행될 수도 있습니다. 백그라운드 컬렉션이 이미 진행 중인 경우 메서드가 즉시 반환됩니다.
Optimized 차단 컬렉션은 가비지 수집기의 상태와 generation 매개 변수에 따라 수행될 수 있습니다. 가비지 수집기는 최적의 성능을 제공하려고 합니다. 가비지 수집기의 상태에 따라 컬렉션이 수행될 수 있습니다. Collect(Int32, GCCollectionMode, Boolean) 메서드는 백그라운드 컬렉션을 요청하지만 이 작업이 항상 수행되지는 않으며 상황에 따라 차단 컬렉션이 계속 수행될 수도 있습니다. 가비지 수집기는 최적의 성능을 제공하려고 합니다. 백그라운드 컬렉션이 이미 진행 중인 경우 메서드가 즉시 반환됩니다.

메서드에 대한 호출이 Collect(Int32, GCCollectionMode, Boolean) 전체 차단 가비지 수집을 수행하는 경우 메서드를 호출하기 전에 속성을 로 설정 GCSettings.LargeObjectHeapCompactionMode 하여 큰 개체 힙을 Collect 압축할 GCLargeObjectHeapCompactionMode.CompactOnce 수도 있습니다.

적용 대상

.NET 9 및 기타 버전
제품 버전
.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 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

Collect(Int32, GCCollectionMode, Boolean, Boolean)

Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs
Source:
GC.CoreCLR.cs

컬렉션이 차단되고 압축되어야 할지 여부를 지정하는 값을 사용하여 GCCollectionMode 값으로 지정된 시간에 0세대에서 지정된 세대까지 가비지 컬렉션을 강제로 실행합니다.

public static void Collect (int generation, GCCollectionMode mode, bool blocking, bool compacting);

매개 변수

generation
Int32

가비지를 수집할 가장 오래된 세대의 수입니다.

mode
GCCollectionMode

이 가비지의 수집 강제 (Default 또는 Forced) 또는 최적화 (Optimized) 여부를 지정하는 열거형 값입니다.

blocking
Boolean

차단 가비지 수집을 수행하려면 true이고, 가능한 경우 백그라운드 가비지 수집을 수행하려면 false입니다.

compacting
Boolean

작은 개체 힙을 압축 하려면 true, 비우기만 하려면 false입니다.

설명

가 인 false경우 blocking GC는 백그라운드 또는 차단 가비지 수집을 수행할지 여부를 결정합니다. 가 이truecompacting 가비지 수집을 차단합니다.

가 이truecompacting 런타임은 SOH(작은 개체 힙)를 압축합니다. 속성이 로 설정GCLargeObjectHeapCompactionMode.CompactOnce되지 않는 한 GCSettings.LargeObjectHeapCompactionMode LOH(큰 개체 힙)는 압축되지 않습니다. 여기에는 전체 차단 가비지 수집뿐만 아니라 모든 차단 가비지 수집이 포함됩니다.

다음 코드 조각과 같이 메서드를 Collect(Int32, GCCollectionMode, Boolean, Boolean) 호출하여 관리되는 힙을 가능한 가장 작은 크기로 줄일 수 있습니다.

GCSettings.LargeObjectHeapCompactionMode = GCLargeObjectHeapCompactionMode.CompactOnce;
GC.Collect(2, GCCollectionMode.Forced, true, true);

인수를 compacting 지정하면 true 압축, 전체 차단 가비지 수집이 보장됩니다. GCSettings.LargeObjectHeapCompactionMode 속성을 로 설정하면 GCLargeObjectHeapCompactionMode.CompactOnce LOH와 SOH가 모두 압축됩니다.

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1