Control.Dispose-Methode

Artikel
08/20/2007

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

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Sub Dispose
'Usage
Dim instance As Control

instance.Dispose

public virtual void Dispose ()

public:
virtual void Dispose ()

public void Dispose ()

public function Dispose ()

Hinweise

Rufen Sie Dispose auf, wenn Control nicht mehr benötigt wird. Die Dispose-Methode bewirkt, dass das Control nicht mehr verwendet werden kann. Nach dem Aufruf dieser Methode müssen Sie alle Verweise auf das Steuerelement freigeben, damit der belegte Speicher während der Garbage Collection wieder zugänglich gemacht werden kann.

Beispiel

Im folgenden Codebeispiel wird die Dispose-Methode überschrieben, um das HtmlTextWriter-Objekt zu schließen, das einem Steuerelement zugeordnet ist. Außerdem wird die Dispose-Methode des Button-Steuerelements myButton aufgerufen. Wenn beim Aufruf dieser Version der Dispose-Methode eine Exception ausgelöst wird, schreibt das Steuerelement eine Meldung in das aktuelle HttpResponse-Objekt.

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

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 void Dispose()
{
    try {
        get_Context().get_Response().Write("Disposing " + ToString());

        // Perform resource cleanup.
        myTextWriter.Close();
        myButton.Dispose();
    }
    catch (System.Exception myException) {
        get_Context().get_Response().Write("Exception occurred: " 
            + myException.get_Message());
    }
} //Dispose

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace

Weitere Ressourcen

Übersicht über den Lebenszyklus von ASP.NET-Seiten
Finalize-Methoden und Destruktoren

Freigeben über