Control.Dispose Metoda

Definice

Umožňuje serverový ovládací prvek provést finální vyčištění před jeho uvolněním z paměti.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 ()

Implementuje

Příklady

Následující příklad kódu přepíše Dispose metodu pro zavření HtmlTextWriter objektu přidruženého k ovládacímu prvku a volání Dispose metody v Button ovládacím prvku s názvem 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. Pokud Exception je vyvolána při volání této verze Dispose metody, ovládací prvek zapíše zprávu do aktuálního HttpResponse objektu.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

Poznámky

Zavolejte Dispose po dokončení používání Control .Call Dispose when you are finished using the Control. DisposeMetoda opouští Control v nepoužitelném stavu.The Dispose method leaves the Control in an unusable state. Po volání této metody je nutné uvolnit všechny odkazy na ovládací prvek, aby paměť, kterou zabíral, mohla být uvolněna uvolňováním paměti.After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.

Platí pro

Viz také