Control.Dispose Метод

Определение

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.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 ()

Реализации

Примеры

В следующем примере кода метод Dispose переопределяется, чтобы закрыть HtmlTextWriter объект, связанный с элементом управления, и вызвать метод Dispose для элемента управления Button с именем 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. Если при вызове этой версии метода Dispose возникает Exception, элемент управления записывает сообщение в текущий объект HttpResponse.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

Комментарии

Вызовите метод Dispose по окончании использования класса Control.Call Dispose when you are finished using the Control. Метод Dispose оставляет класс Control в непригодном для использования состоянии.The Dispose method leaves the Control in an unusable state. После вызова этого метода необходимо освободить все ссылки на элемент управления, чтобы память, которую он занимают, могла быть освобождена при сборке мусора.After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.

Применяется к

Дополнительно