Control.Dispose Method

Definition

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.Enables a server control to perform final clean up before it is released from memory.

public:
 virtual void Dispose();
public virtual void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Overridable Sub Dispose ()

Implements

Examples

L’exemple de code suivant substitue la méthode Dispose pour fermer l’objet HtmlTextWriter associé à un contrôle et appeler la méthode Dispose sur un contrôle Button, nommé myButton.The following code example overrides the Dispose method to close the HtmlTextWriter object associated with a control, and call the Dispose method on a Button control, named myButton. Si une Exception est levée quand cette version de la méthode Dispose est appelée, le contrôle écrit un message dans l’objet HttpResponse en cours.If an Exception is thrown when this version of the Dispose method is called, the control writes a message to the current HttpResponse object.

public override void Dispose()
{
   try
   {
      Context.Response.Write("Disposing " + ToString());
      // Perform resource cleanup.
      myTextWriter.Close();
      myButton.Dispose();
   }
   catch(Exception myException)
   {
      Context.Response.Write("Exception occurred: "+myException.Message);
   }
}
Public Overrides Sub Dispose()
   Try
      Context.Response.Write("Disposing " & ToString())
      ' Perform resource cleanup.
      myTextWriter.Close()
      myButton.Dispose()
   Catch myException As Exception
      Context.Response.Write("Exception occurred: " & myException.Message)
   End Try
End Sub

Remarks

Appelez la méthode Dispose une fois que vous avez terminé d'utiliser Control.Call Dispose when you are finished using the Control. La méthode Dispose rend le Control inutilisable.The Dispose method leaves the Control in an unusable state. Après avoir appelé cette méthode, vous devez libérer toutes les références au contrôle afin que la mémoire qu’elle occupait puisse être récupérée par garbage collection.After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.

Applies to

See also