Control.Dispose メソッド

public:
 virtual void Dispose();

public virtual void Dispose ();

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

Public Overridable Sub Dispose ()

実装

例

次のコード例では、Dispose メソッドをオーバーライドして、コントロールに関連付けられている HtmlTextWriter オブジェクトを閉じ、myButtonという名前の Button コントロールに対して Dispose メソッドを呼び出します。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

注釈

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.

適用対象

こちらもご覧ください

• ASP.NET ページのライフサイクルの概要Introduction to the ASP.NET Page Life Cycle