GC.WaitForPendingFinalizers メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

ファイナライザーのキューを処理するスレッドがそのキューを空にするまで、現在のスレッドを中断します。

C#

public static void WaitForPendingFinalizers ();

例

次の例では、メソッドを WaitForPendingFinalizers 使用して、収集されたすべてのオブジェクトの最終処理が完了するまで現在のスレッドを中断する方法を示します。

C#

using System;

namespace WaitForPendingFinalizersExample
{
   class MyWaitForPendingFinalizersClass
   {
    // You can increase this number to fill up more memory.
    const int numMfos = 1000;
    // You can increase this number to cause more
    // post-finalization work to be done.
    const int maxIterations = 100;

    static void Main(string[] args)
    {
       MyFinalizeObject mfo = null;

       // Create and release a large number of objects
       // that require finalization.
       for(int j = 0; j < numMfos; j++)
       {
          mfo = new MyFinalizeObject();
       }

       //Release the last object created in the loop.
       mfo = null;

       //Force garbage collection.
       GC.Collect();

       // Wait for all finalizers to complete before continuing.
       // Without this call to GC.WaitForPendingFinalizers,
       // the worker loop below might execute at the same time
       // as the finalizers.
       // With this call, the worker loop executes only after
       // all finalizers have been called.
       GC.WaitForPendingFinalizers();

       // Worker loop to perform post-finalization code.
       for(int i = 0; i < maxIterations; i++)
       {
          Console.WriteLine("Doing some post-finalize work");
       }
    }
   }

   class MyFinalizeObject
   {
    // Make this number very large to cause the finalizer to
    // do more work.
    private const int maxIterations = 10000;

    ~MyFinalizeObject()
    {
       Console.WriteLine("Finalizing a MyFinalizeObject");
            
       // Do some work.
       for(int i = 0; i < maxIterations; i++)
       {
          // This method performs no operation on i, but prevents
          // the JIT compiler from optimizing away the code inside
          // the loop.
          GC.KeepAlive(i);
       }
        }
    }
}

注釈

ガベージ コレクターは、再利用できるオブジェクトを見つけると、各オブジェクトをチェックして、オブジェクトの最終処理要件を決定します。 オブジェクトがファイナライザーを実装し、呼び出 SuppressFinalizeして終了処理を無効にしていない場合、オブジェクトは最終処理の準備完了としてマークされているオブジェクトの一覧に配置されます。 ガベージ コレクターは、 Finalize このリスト内のオブジェクトのメソッドを呼び出し、リストからエントリを削除します。 このメソッドは、すべてのファイナライザーが完了するまでブロックします。

ファイナライザーが実行されるスレッドは指定されていないため、このメソッドが終了する保証はありません。 ただし、このスレッドは、メソッドの進行中に別の WaitForPendingFinalizers スレッドによって中断される可能性があります。 たとえば、一定期間待機する別のスレッドを開始し、このスレッドがまだ中断されている場合は、このスレッドを中断できます。

適用対象