Control.Dispose Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.

public:
 virtual void Dispose();

public virtual void Dispose();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Overridable Sub Dispose ()

Implementiert

Dispose()

Beispiele

Im folgenden Codebeispiel wird die Dispose -Methode außer Kraft gesetzt, um das HtmlTextWriter einem Steuerelement zugeordnete Objekt zu schließen und die Dispose -Methode für ein Button Steuerelement mit dem Namen myButtonaufzurufen. Wenn ein Exception ausgelöst wird, wenn diese Version der Dispose Methode aufgerufen wird, schreibt das Steuerelement eine Nachricht in das aktuelle HttpResponse Objekt.

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. Die Dispose-Methode bewirkt, dass Control nicht mehr verwendet werden kann. Nachdem Sie diese Methode aufgerufen haben, müssen Sie alle Verweise auf das Steuerelement freigeben, damit der belegte Arbeitsspeicher von der Garbage Collection zurückgewonnen werden kann.

Gilt für:

Produkt	Versionen
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Weitere Informationen

Einführung in den lebenszyklus von ASP.NET Seiten

Teilen über