GC クラス

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

未使用メモリを自動的に収集するサービスであるシステムガベージコレクターを制御します。

public ref class GC abstract sealed

public ref class GC sealed

public static class GC

public sealed class GC

type GC = class

Public Class GC

Public NotInheritable Class GC

継承: Object
GC

例

次の例では、いくつかの GC メソッドを使用して、未使用のオブジェクトのブロックに関する生成情報とメモリ情報を取得し、コンソールに出力します。未使用のオブジェクトが収集され、結果のメモリ合計が表示されます。

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

open System

let maxGarbage = 1000

type MyGCCollectClass() =
    member _.MakeSomeGarbage() =
        for _ = 1 to maxGarbage do
            // Create objects and release them to fill up memory with unused objects.
            Version() |> ignore

[<EntryPoint>]
let main _ =
    let myGCCol = MyGCCollectClass()

    // Determine the maximum number of generations the system
    // garbage collector currently supports.
    printfn $"The highest generation is {GC.MaxGeneration}"

    myGCCol.MakeSomeGarbage()

    // Determine which generation myGCCol object is stored in.
    printfn $"Generation: {GC.GetGeneration myGCCol}"

    // Determine the best available approximation of the number
    // of bytes currently allocated in managed memory.
    printfn $"Total Memory: {GC.GetTotalMemory false}"

    // Perform a collection of generation 0 only.
    GC.Collect 0

    // Determine which generation myGCCol object is stored in.
    printfn $"Generation: {GC.GetGeneration myGCCol}"

    printfn $"Total Memory: {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.
    printfn $"Generation: {GC.GetGeneration myGCCol}"
    printfn $"Total Memory: {GC.GetTotalMemory false}"

    0

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

注釈

ガベージコレクターは、マネージドメモリの割り当てと解放を制御する共通言語ランタイムコンポーネントです。このクラスのメソッドは、オブジェクトに対してガベージコレクションが実行される場合と、オブジェクトによって割り当てられたリソースが解放されるときに影響します。このクラスのプロパティは、システムで使用可能なメモリの合計量と、オブジェクトに割り当てられたメモリの有効期間カテゴリ (世代) に関する情報を提供します。

ガベージコレクターは、マネージドメモリに割り当てられたオブジェクトを追跡して再利用します。ガベージコレクターは定期的にガベージコレクションを実行して、有効な参照がないオブジェクトに割り当てられたメモリを再利用します。ガベージコレクションは、使用可能な空きメモリを使用してメモリの要求を満たすことができない場合に自動的に発生します。または、アプリケーションでメソッドを使用してガベージコレクションを Collect 強制することもできます。

ガベージコレクションは、次の手順で構成されます。

ガベージコレクターは、マネージドコードで参照されているマネージドオブジェクトを検索します。
ガベージコレクターは、参照されていないオブジェクトの最終処理を試みます。
ガベージコレクターは、参照されていないオブジェクトを解放し、メモリを再利用します。

このトピックのセクションは次のとおりです。

ガベージコレクターとアンマネージドリソースオブジェクトのエージングと世代ガベージコレクションの禁止

ガベージコレクターとアンマネージリソース

コレクション中、ガベージコレクターは、マネージドコードでオブジェクトへの 1 つ以上の参照を見つけた場合、オブジェクトを解放しません。ただし、ガベージコレクターはアンマネージコードからのオブジェクトへの参照を認識せず、明示的に禁止されていない限り、アンマネージコードでのみ使用されているオブジェクトを解放する可能性があります。メソッドは KeepAlive 、ガベージコレクターがアンマネージドコードでまだ使用されているオブジェクトを収集できないようにするメカニズムを提供します。

マネージドメモリの割り当てとは別に、ガベージコレクターの実装では、ファイルハンドルやデータベース接続など、オブジェクトによって保持されているリソースに関する情報は保持されません。型のインスタンスを再利用する前に解放する必要があるアンマネージリソースを型で使用する場合、型はファイナライザーを実装できます。

ほとんどの場合、ファイナライザーはメソッドを Object.Finalize オーバーライドすることによって実装されます。ただし、C# または C++ で記述された型はデストラクターを実装し、コンパイラはの Object.Finalizeオーバーライドになります。ほとんどの場合、オブジェクトにファイナライザーがある場合、ガベージコレクターはオブジェクトを解放する前に呼び出します。ただし、ガベージコレクターは、すべての状況でファイナライザーを呼び出す必要はありません。たとえば、メソッドを SuppressFinalize 使用すると、オブジェクトのファイナライザーが明示的に呼び出されなくなります。また、ガベージコレクターは、特定のスレッドを使用してオブジェクトをファイナライズしたり、相互に参照するがガベージコレクションで使用できるオブジェクトに対してファイナライザーが呼び出される順序を保証したりする必要はありません。

リソースを特定の時刻に解放する必要があるシナリオでは、クラスはインターフェイスを IDisposable 実装できます。このインターフェイスには、リソース管理タスクとクリーンアップタスクを IDisposable.Dispose 実行するメソッドが含まれています。を実装Disposeするクラスでは、クラスコンシューマーがメソッドを呼び出してオブジェクトをクリーンする場合、クラスコントラクトの一部としてを指定する必要があります。ガベージコレクターは、既定ではメソッドを Dispose 呼び出しません。ただし、メソッドの Dispose 実装では、クラスのメソッドを GC 呼び出して、ガベージコレクターの終了動作をカスタマイズできます。

オブジェクトの最終処理と破棄パターンの詳細については、「アンマネージリソースのクリーンアップ」を参照してください。

オブジェクトのエイジングと世代

共通言語ランタイムのガベージコレクターでは、世代を使用したオブジェクトのエージングがサポートされています。生成は、メモリ内のオブジェクトの相対的な経過時間の測定単位です。オブジェクトの世代番号 (年齢) は、オブジェクトが属する世代を示します。最近作成されたオブジェクトは新しい世代の一部であり、アプリケーションのライフサイクルで以前に作成されたオブジェクトよりも世代番号が少なくなっています。最新世代のオブジェクトは、ジェネレーション 0 にあります。ガベージコレクターのこの実装では、ジェネレーション 0、1、2 の 3 つの世代のオブジェクトがサポートされています。プロパティの値を取得して、 MaxGeneration システムでサポートされている最大世代数を決定できます。

オブジェクトのエージングにより、アプリケーションは、ガベージコレクターですべての世代を評価する必要はなく、特定の世代のセットでガベージコレクションをターゲットにできます。パラメーターを含むメソッドの Collect オーバーロードを generation 使用すると、ガベージコレクションする最も古い世代を指定できます。

ガベージコレクションの禁止

.NET Framework 4.6 以降、ガベージコレクターは、ガベージコレクションがアプリのパフォーマンスに悪影響を与える可能性があるクリティカルパスの実行中に使用できる GC 領域待機時間モードをサポートしません。 GC 領域待機時間モードを使用しない場合、ガベージコレクターからの干渉なしに割り当てることができるメモリの量を指定する必要があります。ランタイムがそのメモリを割り当てることができる場合、クリティカルパス内のコードが実行されている間、ランタイムはガベージコレクションを実行しません。

のオーバーロードのいずれかを呼び出して、GC 領域なしのクリティカルパスの先頭を TryStartNoGCRegion定義します。メソッドを呼び出して、クリティカルパスの末尾を EndNoGCRegion 指定します。

メソッドの呼び出しを TryStartNoGCRegion 入れ子にすることはできません。ランタイムが現在 GC リージョン待機時間モードになっていない場合にのみ、メソッドを呼び出 EndNoGCRegion す必要があります。つまり、(最初のメソッド呼び出しの後、後続の呼び出しは成功しません) を複数回呼び TryStartNoGCRegion 出すべきではありません。また、最初の呼び出しが成功したからといって、の EndNoGCRegion 呼び出し TryStartNoGCRegion が成功することは想定しないでください。

プロパティ

MaxGeneration

システムが現在サポートしている最大のジェネレーション番号を取得します。

メソッド

AddMemoryPressure(Int64)	アンマネージメモリが大規模に割り当てられたため、ガベージコレクションをスケジュールするときに考慮する必要があることが、ランタイムに通知されます。
AllocateArray<T>(Int32, Boolean)	配列を割り当てます。
AllocateUninitializedArray<T>(Int32, Boolean)	可能な場合は、ゼロ初期化のスキップ中に配列を割り当てます。
CancelFullGCNotification()	ガベージコレクションの通知の登録をキャンセルします。
Collect()	すべてのジェネレーションのガベージコレクションを直ちに強制実行します。
Collect(Int32)	ジェネレーション 0 から指定ジェネレーションまでのガベージコレクションを直ちに強制実行します。
Collect(Int32, GCCollectionMode)	GCCollectionMode 値によって指定したタイミングで、ジェネレーション 0 から指定ジェネレーションまでのガベージコレクションを強制的に実行します。
Collect(Int32, GCCollectionMode, Boolean)	ジェネレーション 0 から指定ジェネレーションまでのガベージコレクションを、 GCCollectionMode 値で指定したタイミングで強制実行します。コレクションをブロックする必要があるかどうかを指定する値を指定します。
Collect(Int32, GCCollectionMode, Boolean, Boolean)	ジェネレーション 0 から指定ジェネレーションまでのガベージコレクションを、 GCCollectionMode 値で指定したタイミングで強制実行します。コレクションをブロックおよび圧縮する必要があるかどうかを指定する値を指定します。
CollectionCount(Int32)	指定したジェネレーションのオブジェクトに対するガベージコレクションの発生回数を返します。
EndNoGCRegion()	GC 領域の無待機モードを終了します。
GetAllocatedBytesForCurrentThread()	その有効期間の開始以降、現在のスレッドに割り当てられた総バイト数を取得します。
GetConfigurationVariables()	ガベージコレクターによって使用される構成を取得します。
GetGCMemoryInfo()	ガベージコレクションのメモリ情報を取得します。
GetGCMemoryInfo(GCKind)	ガベージコレクションのメモリ情報を取得します。
GetGeneration(Object)	指定したオブジェクトの現在のジェネレーション番号を返します。
GetGeneration(WeakReference)	指定した弱い参照の対象となる現在のジェネレーション番号を返します。
GetTotalAllocatedBytes(Boolean)	プロセスの有効期間にわたって割り当てられたバイト数を取得します。戻り値には、ネイティブ割り当ては含まれません。
GetTotalMemory(Boolean)	断片化を除くヒープサイズを取得します。たとえば、GC ヒープの合計サイズが 100 mb で、断片化 (空きオブジェクトによって占有される領域) が 40 mb を占める場合、この API は 60 mb を報告します。パラメーターは、このメソッドが制御を戻す前に短い時間だけ待機して、システムがガベージコレクションを行い、オブジェクトの終了操作を実行できるようにするかどうかを示します。
GetTotalPauseDuration()	プロセスの開始以降に GC で一時停止された合計時間を取得します。
KeepAlive(Object)	指定したオブジェクトを参照することにより、現在のルーチンの開始時からこのメソッドが呼び出される時点までの間、そのオブジェクトをガベージコレクションの対象から外します。
RefreshMemoryLimit()	システム上のさまざまなメモリ制限を検出して、ガベージコレクター自体を再構成するように指示します。
RegisterForFullGCNotification(Int32, Int32)	フルガベージコレクションの可能性が高い状態のとき、およびガベージコレクションが完了したときに、ガベージコレクションの通知を発行する必要があることを指定します。
RegisterNoGCRegionCallback(Int64, Action)	GC 領域に一定量のメモリが割り当てられたときに呼び出されるコールバックを登録します。
RemoveMemoryPressure(Int64)	アンマネージメモリが解放され、ガベージコレクションのスケジュールにこのメモリを考慮する必要がなくなったことをランタイムに通知します。
ReRegisterForFinalize(Object)	SuppressFinalize(Object) が事前に呼び出されている指定オブジェクトに対して、ファイナライザーを呼び出すことをシステムに要求します。
SuppressFinalize(Object)	指定したオブジェクトに対してファイナライザーを呼び出さないよう共通言語ランタイムに要求します。
TryStartNoGCRegion(Int64)	指定した量のメモリを使用可能な場合、クリティカルパスの実行中にガベージコレクションが行われないよう、試行します。
TryStartNoGCRegion(Int64, Boolean)	指定した量のメモリを使用可能な場合は、クリティカルパスの実行中にガベージコレクションが行われないよう、試行します。また、最初に十分な量のメモリを使用できない場合に、ガベージコレクターがフルブロッキングガベージコレクションを実行するかどうかを制御します。
TryStartNoGCRegion(Int64, Int64)	大きなオブジェクトヒープおよび小さなオブジェクトヒープに対して、指定した量のメモリを使用可能な場合、クリティカルパスの実行中にガベージコレクションが行われないよう、試行します。
TryStartNoGCRegion(Int64, Int64, Boolean)	大きなオブジェクトヒープおよび小さなオブジェクトヒープに対して、指定した量のメモリを使用可能な場合は、クリティカルパスの実行中にガベージコレクションが行われないよう、試行します。また、最初に十分な量のメモリを使用できない場合に、ガベージコレクターがフルブロッキングガベージコレクションを実行するかどうかを制御します。
WaitForFullGCApproach()	共通言語ランタイムによるフルブロッキングガベージコレクションが近づいているかどうかを確認するための、登録済みの通知の状態を返します。
WaitForFullGCApproach(Int32)	共通言語ランタイムによるフルブロッキングガベージコレクションが近づいているかどうかを確認するための登録済みの通知の状態を、指定したタイムアウト時間で返します。
WaitForFullGCApproach(TimeSpan)	共通言語ランタイムによるフルブロッキングガベージコレクションが近づいているかどうかを確認するための登録済みの通知の状態を、指定したタイムアウト時間で返します。
WaitForFullGCComplete()	共通言語ランタイムによるフルブロッキングガベージコレクションが完了したかどうかを確認するための、登録済みの通知の状態を返します。
WaitForFullGCComplete(Int32)	共通言語ランタイムによるフルブロッキングガベージコレクションが完了したかどうかを確認するための登録済みの通知の状態を、指定したタイムアウト時間で返します。
WaitForFullGCComplete(TimeSpan)	ブロッキングガベージコレクションが完了したかどうかに関する登録済み通知の状態を返します。完全なコレクションを無期限に待機できます。
WaitForPendingFinalizers()	ファイナライザーのキューを処理するスレッドがそのキューを空にするまで、現在のスレッドを中断します。

適用対象

GC クラス

定義

例

注釈

ガベージコレクターとアンマネージリソース

オブジェクトのエイジングと世代

ガベージコレクションの禁止

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース

GC クラス

定義

例

注釈

ガベージ コレクターとアンマネージ リソース

オブジェクトのエイジングと世代

ガベージ コレクションの禁止

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース

ガベージコレクターとアンマネージリソース

ガベージコレクションの禁止