INFO : Implémentation de la méthode Dispose dans une classe dérivée

Lorsque vous créez une classe qui étend une classe de base, vous devez gérer la libération des ressources allouées, d'une manière ou d'une autre. Pour ce faire, la méthode Dispose de la classe de base doit être substituée (redéclarée) dans les classes dérivées. Cet article aborde des problèmes couramment rencontrés dans ce scénario et explique la procédure à suivre pour substituer (redéclarer) correctement la méthode Dispose. Il est destiné à clarifier certaines des subtilités de l'article d'Aide Visual Basic .NET suivant : Consultez ce document d'Aide pour obtenir des informations détaillées sur la gestion des erreurs et des exemples généraux de la méthode Dispose.

Une classe de base doit contenir un ensemble surchargé de méthodes Dispose. La première instance de l'exemple de code qui suit est une version sans paramètres, et la seconde instance accepte un paramètre booléen :

Dispose() est la méthode appelée lorsqu'un objet est supprimé du code dans lequel il a été créé. C'est une méthode Public. Par conséquent, elle peut être utilisée lorsqu'une instance de la classe existe. La méthode Dispose() appelle ensuite la méthode Dispose(Boolean) et passe une valeur TRUE. La méthode Dispose(Boolean) est responsable du nettoyage des ressources de la classe.

Lorsqu'une classe est dérivée d'une classe de base, seule la méthode Dispose(Boolean) doit être substituée. Tout le nettoyage des ressources de la classe dérivée est effectué dans cette méthode substituée, puis la méthode Dispose(Boolean) pour la classe de base est appelée. Voici un exemple primitif de la fonction substituant la classe de base : La classe dérivée ne nécessite pas de méthode Dispose() car cette méthode est héritée de la classe de base. Lorsque la méthode Dispose() est appelée sur une instance de la classe dérivée, elle utilise la méthode Dispose(Boolean) de la classe dérivée plutôt que celle de la classe de base. Il est alors important que la méthode Dispose(Boolean) de la classe dérivée appelle la méthode Dispose(Boolean) de la classe de base. Cette opération est effectuée à l'aide de la méthode MyBase.Dispose(disposing). La méthode Dispose(Boolean) de la classe de base doit être appelée pour garantir que les ressources de la classe de base sont également supprimées.

Dispose() sert de point d'entrée pour l'accès public à la suppression d'un objet et permet de garantir que la valeur TRUE est passée à la méthode Dispose(Boolean). La valeur FALSE doit être passée uniquement lorsque la méthode Dispose(Boolean) est appelée par la méthode d'exécution ou la méthode Finalize. Lorsque la valeur FALSE est passée, seules les ressources non gérées sont supprimées. Lorsque la valeur TRUE est passée, les ressources gérées et non gérées sont supprimées.

L'environnement de développement Visual Studio insère le code pour substituer la méthode Dispose() dans une classe qui hérite d'un objet système (par exemple, Inherits System.Windows.Forms.TextBox). Cela s'effectue à partir des menus (situés, par défaut, en haut de la fenêtre de code) en sélectionnant Substitutions, puis en cliquant sur Dispose(). Le code inséré ressemble à celui-ci : Si cette opération est effectuée, aucune erreur de compilation n'est générée. Cependant, lorsque la classe dérivée est chargée pendant l'exécution, vous recevez un message d'erreur d'exécution semblable au suivant : REMARQUE : La valeur Type sera différente de celle spécifiée dans l'exemple précédent. Elle correspond simplement au nom de la classe qui a tenté d'utiliser une méthode Dispose() incorrectement substituée.

Pour corriger ce problème, il vous suffit de surcharger la méthode Dispose(Boolean) au lieu de Dispose(), et de vous assurer qu'un appel est effectué à la méthode Dispose(Boolean) de la classe de base et que la valeur TRUE est passée à cette méthode.

REMARQUE : Dans Visual Basic .NET, le mot clé Overridable est utilisé comme le mot clé Virtual dans C# et C++. Les méthodes sont, par défaut, NotOverridable.

Rubriques d'aide connexes :

• Implémentation de la méthode Dispose (http://msdn.microsoft.com/library/en-us/cpguide/html/cpconimplementingdisposemethod.asp)
• Implémentation des méthodes Finalize et Dispose pour nettoyer des ressources non gérées (http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconfinalizedispose.asp)