Control.Dispose Methode

Definition

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.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 ()

Implementiert

Beispiele

Im folgenden Codebeispiel wird die Dispose-Methode überschrieben, um das einem-Steuerelement zugeordnete HtmlTextWriter-Objekt zu schließen und die Dispose-Methode für ein Button Steuerelement mit dem Namen myButtonaufzurufen.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. Wenn eine Exception ausgelöst wird, wenn diese Version der Dispose-Methode aufgerufen wird, schreibt das-Steuerelement eine Meldung in das aktuelle HttpResponse-Objekt.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

Hinweise

Rufen Sie Dispose auf, wenn Sie Control nicht mehr benötigen.Call Dispose when you are finished using the Control. Die Dispose-Methode bewirkt, dass Control nicht mehr verwendet werden kann.The Dispose method leaves the Control in an unusable state. Nachdem Sie diese Methode aufgerufen haben, müssen Sie alle Verweise auf das-Steuerelement freigeben, damit der Arbeitsspeicher, den Sie belegen, von Garbage Collection freigegeben werden kann.After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.

Gilt für:

Siehe auch