Control.Dispose Control.Dispose Control.Dispose Control.Dispose Method

定義

サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。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. 場合、Exceptionときにスローされるは、このバージョン、Disposeメソッドが呼び出されると、コントロール メッセージを現在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

注釈

Control を使い終わったら、Disposeを呼び出します。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.

適用対象

こちらもご覧ください