Object.Finalize, méthode

La méthode Finalize est utilisée pour exécuter des opérations de nettoyage sur les ressources non managées détenues par l'objet actif avant que l'objet actif ne soit détruit. La méthode est protégée et n'est donc accessible qu'à l'aide de cette classe ou d'une classe dérivée.

Cette méthode est automatiquement appelée lorsqu'un objet devient inaccessible, à moins qu'il ait été dispensé de finalisation par un appel à GC.SuppressFinalize. Pendant l'arrêt d'un domaine d'application, Finalize est appelé automatiquement sur des objets qui ne sont pas exempts de finalisation, même ceux qui sont encore accessibles. Finalize n'est automatiquement appelé qu'une seule fois sur une instance donnée, à moins que l'objet soit réinscrit à l'aide d'un mécanisme tel que GC.ReRegisterForFinalize et que GC.SuppressFinalize n'ait pas été appelé par la suite.

Toutes les implémentations de Finalize dans un type dérivé doivent appeler l'implémentation de Finalize de leur type de base. Il s'agit du seul cas où le code d'application est autorisé à appeler Finalize.

Remarque
Étant donné que le compilateur C# ne vous permet pas d'implémenter directement la méthode Finalize, un destructeur C# appelle automatiquement le destructeur de sa classe de base.

Les opérations Finalize possèdent les restrictions suivantes :

• L'heure exacte à laquelle le finaliseur s'exécute pendant l'opération garbage collection n'est pas définie. Il n'est pas garanti que les ressources seront libérées à une heure déterminée, sauf si vous appelez une méthode Close ou Dispose.

• Il n'est pas garanti que les finaliseurs de deux objets s'exécuteront dans un ordre déterminé, même si un objet fait référence à l'autre. Cela signifie que si l'objet A fait référence à l'objet B et si les deux objets possèdent des finaliseurs, l'objet B peut avoir terminé la finalisation lorsque le finaliseur de l'objet A démarre.

• Le thread sur lequel s'exécute le finaliseur n'est pas spécifié.

Il se peut que la méthode Finalize ne s'exécute pas complètement ou pas du tout dans les circonstances exceptionnelles suivantes :

• Un autre finaliseur se bloque indéfiniment (entre dans une boucle sans fin, tente en vain d'obtenir un verrouillage, etc.). Comme le runtime tente d'exécuter des finaliseurs jusqu'à la fin, il se peut que les autres finaliseurs ne soient pas appelés si l'un d'eux se bloque indéfiniment.

• Le processus se termine sans donner au runtime une chance de remettre tout en ordre. Dans ce cas, la première notification de l'achèvement du processus du runtime est une notification DLL_PROCESS_DETACH.

Le runtime continue à finaliser (Finalize) des objets pendant l'arrêt aussi longtemps que le nombre d'objets finalisables diminue.

Si Finalize ou une substitution de Finalize lève une exception, et que le runtime n'est pas hébergé par une application qui substitue la stratégie par défaut, le runtime termine le processus et aucun bloc try-finally actif ni aucun finaliseur n'est exécuté. Ce comportement garantit l'intégrité du processus si le finaliseur ne peut pas libérer ou détruire des ressources.

Object.Finalize n'a aucun effet par défaut. Il ne doit être substitué par une classe dérivée qu'en cas de nécessité, car toute récupération pendant une opération garbage collection dure bien plus longtemps si une opération Finalize doit être exécutée.

Si Object contient des références à des ressources, Finalize doit être substitué par une classe dérivée afin de libérer ces ressources avant que Object soit ignoré pendant l'opération garbage collection.

Un type doit implémenter Finalize s'il utilise des ressources non managées, telles que des handles de fichiers ou des connexions de bases de données, qui doivent être libérées en cas de récupération de l'objet managé qui les emploie. Pour un moyen complémentaire et plus contrôlable de détruire les ressources, consultez l'interface IDisposable.

Finalize peut effectuer n'importe quelle action, y compris ressusciter (rendre à nouveau accessible) un objet qui a été nettoyé pendant une opération garbage collection. Cependant, l'objet ne peut être ressuscité qu'une seule fois. Finalize ne peut pas être appelé sur des objets ressuscités pendant une opération garbage collection.

Les destructeurs constituent le mécanisme C# permettant d'effectuer des opérations de nettoyage. Ils fournissent une sécurité appropriée, par exemple en appelant automatiquement le destructeur du type de base. Dans le code C#, Object.Finalize ne peut pas être appelé ou substitué.

L'exemple suivant vérifie que la méthode Finalize est appelée lorsqu'un objet qui substitue Finalize est détruit. Notez que, dans une application de production, la méthode Finalize est substituée pour libérer des ressources non managées retenues par l'objet. Notez également que l'exemple de code C# fournit un destructeur au lieu de substituer la méthode Finalize.

using System;
using System.Diagnostics;

public class ExampleClass
{
   Stopwatch sw;

   public ExampleClass()
   {
      sw = Stopwatch.StartNew();
      Console.WriteLine("Instantiated object");
   } 

   public void ShowDuration()
   {
      Console.WriteLine("This instance of {0} has been in existence for {1}",
                        this, sw.Elapsed);
   }

   ~ExampleClass()
   {
      Console.WriteLine("Finalizing object");
      sw.Stop();
      Console.WriteLine("This instance of {0} has been in existence for {1}",
                        this, sw.Elapsed);
   }
}

public class Demo
{
   public static void Main()
   {
      ExampleClass ex = new ExampleClass();
      ex.ShowDuration();
   }
}
// The example displays output like the following:
//    Instantiated object
//    This instance of ExampleClass has been in existence for 00:00:00.0011060
//    Finalizing object
//    This instance of ExampleClass has been in existence for 00:00:00.0036294

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence