GC.ReRegisterForFinalize(Object) メソッド

public:
 static void ReRegisterForFinalize(System::Object ^ obj);

public static void ReRegisterForFinalize(object obj);

static member ReRegisterForFinalize : obj -> unit

Public Shared Sub ReRegisterForFinalize (obj As Object)

パラメーター

例外

例

次の例では、 ReRegisterForFinalize メソッドを使用して、ガベージ コレクション後に 2 回目にオブジェクトを最終処理する方法を示します。

using System;

namespace ReRegisterForFinalizeExample
{
    class MyMainClass
    {
        static void Main()
        {
            // Create a MyFinalizeObject.
            MyFinalizeObject mfo = new MyFinalizeObject();

            // Release the reference to mfo.
            mfo = null;

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

            // At this point mfo will have gone through the first Finalize.
            // There should now be a reference to mfo in the static
            // MyFinalizeObject.currentInstance field.  Setting this value
            // to null and forcing another garbage collection will now
            // cause the object to Finalize permanently.
            MyFinalizeObject.currentInstance = null;
            GC.Collect();
        }
    }

    class MyFinalizeObject
    {
        public static MyFinalizeObject currentInstance = null;
        private bool hasFinalized = false;

        ~MyFinalizeObject()
        {
            if(!hasFinalized)
            {
                Console.WriteLine("First finalization");

                // Put this object back into a root by creating
                // a reference to it.
                MyFinalizeObject.currentInstance = this;

                // Indicate that this instance has finalized once.
                hasFinalized = true;

                // Place a reference to this object back in the
                // finalization queue.
                GC.ReRegisterForFinalize(this);
            }
            else
            {
                Console.WriteLine("Second finalization");
            }
        }
    }
}

open System

[<AllowNullLiteral>]
type MyFinalizeObject() =
    let mutable hasFinalized = false
    
    static member val CurrentInstance = null with get, set

    override this.Finalize() =
        if hasFinalized then
            printfn "First finalization"

            // Put this object back into a root by creating a reference to it.
            MyFinalizeObject.CurrentInstance <- this

            // Indicate that this instance has finalized once.
            hasFinalized <- true

            // Place a reference to this object back in the finalization queue.
            GC.ReRegisterForFinalize this
        else 
            printfn "Second finalization"

// Create a MyFinalizeObject.
let mutable mfo = MyFinalizeObject()

// Release the reference to mfo.
mfo <- null

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

// At this point mfo will have gone through the first Finalize.
// There should now be a reference to mfo in the static
// MyFinalizeObject.CurrentInstance property. Setting this value
// to null and forcing another garbage collection will now
// cause the object to Finalize permanently.
MyFinalizeObject.CurrentInstance <- null
GC.Collect()

Namespace ReRegisterForFinalizeExample
    Class MyMainClass
        Shared Sub Main()
            'Create a MyFinalizeObject.
            Dim mfo As New MyFinalizeObject()

            'Release the reference to mfo.
            mfo = Nothing

            'Force a garbage collection.
            GC.Collect()

            'At this point mfo will have gone through the first Finalize.
            'There should now be a reference to mfo in the static
            'MyFinalizeObject.currentInstance field.  Setting this value
            'to null and forcing another garbage collection will now
            'cause the object to Finalize permanently.
            MyFinalizeObject.currentInstance = Nothing
            GC.Collect()
        End Sub
    End Class

    Class MyFinalizeObject
        Public Shared currentInstance As MyFinalizeObject = Nothing
        Private hasFinalized As Boolean = False

        Protected Overrides Sub Finalize()
            If hasFinalized = False Then
                Console.WriteLine("First finalization")

                'Put this object back into a root by creating
                'a reference to it.
                MyFinalizeObject.currentInstance = Me

                'Indicate that this instance has finalized once.
                hasFinalized = True

                'Place a reference to this object back in the
                'finalization queue.
                GC.ReRegisterForFinalize(Me)
            Else
                Console.WriteLine("Second finalization")
            End If
            MyBase.Finalize()
        End Sub
    End Class
End Namespace

注釈

ReRegisterForFinalize メソッドは、ガベージ コレクターがオブジェクトを解放する前に、最終処理を要求するオブジェクトの一覧に obj パラメーターを追加します。 obj パラメーターは、このメソッドの呼び出し元である必要があります。

ReRegisterForFinalize メソッドを呼び出しても、ガベージ コレクターがオブジェクトのファイナライザーを呼び出すことは保証されません。

既定では、ファイナライザーを実装するすべてのオブジェクトが、ファイナライズを必要とするオブジェクトの一覧に追加されます。ただし、オブジェクトが既にファイナライズされているか、 SuppressFinalize メソッドを呼び出してファイナライズを無効にしている可能性があります。

ファイナライザーは、このメソッドを使用して、それ自体または参照するオブジェクトを再取得できます。

こちらもご覧ください

• SuppressFinalize(Object)