GC.WaitForPendingFinalizers Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zawiesza bieżący wątek, dopóki wątek, który przetwarza kolejkę finalizatorów, opróżnia kolejkę.
public:
static void WaitForPendingFinalizers();public static void WaitForPendingFinalizers ();static member WaitForPendingFinalizers : unit -> unitPublic Shared Sub WaitForPendingFinalizers ()Przykłady
W poniższym przykładzie pokazano, jak za pomocą WaitForPendingFinalizers metody wstrzymać bieżący wątek do momentu ukończenia finalizacji wszystkich zebranych obiektów.
using namespace System;
ref class MyFinalizeObject
{
private:
// Make this number very large to cause the finalizer to
// do more work.
literal 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 );
}
}
};
// 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;
int main()
{
MyFinalizeObject^ mfo = nullptr;
// Create and release a large number of objects
// that require finalization.
for ( int j = 0; j < numMfos; j++ )
{
mfo = gcnew MyFinalizeObject;
}
//Release the last object created in the loop.
mfo = nullptr;
//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" );
}
}
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);
}
}
}
}
open System
// You can increase this number to fill up more memory.
let numMfos = 1000
// You can increase this number to cause more
// post-finalization work to be done.
let maxIterations = 100
[<AllowNullLiteral>]
type MyFinalizeObject() =
// Make this number very large to cause the finalizer todo more work.
let maxIterations = 10000
override _.Finalize() =
printfn "Finalizing a MyFinalizeObject"
// Do some work.
for i = 1 to maxIterations do
// This method performs no operation on i, but prevents
// the JIT compiler from optimizing away the code inside
// the loop.
GC.KeepAlive i
let mutable mfo = null
// Create and release a large number of objects
// that require finalization.
for j = 1 to numMfos do
mfo <- 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 _ = 1 to maxIterations do
printfn "Doing some post-finalize work"
Namespace WaitForPendingFinalizersExample
Class MyWaitForPendingFinalizersClass
' You can increase this number to fill up more memory.
Private Const numMfos As Integer = 1000
' You can increase this number to cause more
' post-finalization work to be done.
Private Const maxIterations As Integer = 100
Overloads Shared Sub Main()
Dim mfo As MyFinalizeObject = Nothing
' Create and release a large number of objects
' that require finalization.
Dim j As Integer
For j = 0 To numMfos - 1
mfo = New MyFinalizeObject()
Next j
'Release the last object created in the loop.
mfo = Nothing
'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.
Dim i As Integer
For i = 0 To maxIterations - 1
Console.WriteLine("Doing some post-finalize work")
Next i
End Sub
End Class
Class MyFinalizeObject
' Make this number very large to cause the finalizer to
' do more work.
Private maxIterations As Integer = 10000
Protected Overrides Sub Finalize()
Console.WriteLine("Finalizing a MyFinalizeObject")
' Do some work.
Dim i As Integer
For i = 0 To maxIterations - 1
' This method performs no operation on i, but prevents
' the JIT compiler from optimizing away the code inside
' the loop.
GC.KeepAlive(i)
Next i
MyBase.Finalize()
End Sub
End Class
End Namespace
Uwagi
Gdy moduł odśmiecania pamięci znajdzie obiekty, które można odzyskać, sprawdza każdy obiekt w celu określenia wymagań dotyczących finalizacji obiektu. Jeśli obiekt implementuje finalizator i nie wyłączył finalizacji przez wywołanie metody SuppressFinalize, obiekt zostanie umieszczony na liście obiektów oznaczonych jako gotowe do sfinalizowania. Moduł odśmieceń pamięci wywołuje Finalize metody obiektów na tej liście i usuwa wpisy z listy. Ta metoda blokuje, dopóki wszystkie finalizatory nie będą uruchamiane do ukończenia.
Wątek, na którym są uruchamiane finalizatory, jest nieokreślony, więc nie ma gwarancji, że ta metoda zakończy się. Jednak ten wątek może zostać przerwany przez inny wątek, gdy WaitForPendingFinalizers metoda jest w toku. Można na przykład uruchomić inny wątek, który czeka przez pewien czas, a następnie przerywa ten wątek, jeśli ten wątek jest nadal zawieszony.