Control.Dispose

.NET Framework クラス ライブラリ リファレンス

Control.Dispose メソッド

サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub Dispose

Visual Basic (使用法)

Dim instance As Control

instance.Dispose

C#

public virtual void Dispose ()

C++

public:
virtual void Dispose ()

J#

public void Dispose ()

JScript

public function Dispose ()

解説

Control を使い終わったら、Dispose を呼び出します。Dispose メソッドは、Control を使用できない状態にします。このメソッドを呼び出した後で、コントロールへのすべての参照を解放し、占有されていたメモリをガベージ コレクションでクリアできるようにする必要があります。

使用例

Dispose メソッドをオーバーライドし、コントロールに関連付けられている HtmlTextWriter オブジェクトを閉じて、myButton という名前の Button コントロールで Dispose メソッドを呼び出すコード例を次に示します。このバージョンの Dispose メソッドが呼び出されるときに Exception がスローされた場合は、現在の HttpResponse オブジェクトにメッセージが書き込まれます。

Visual Basic

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

C#

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);
   }
}

J#

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
その他の技術情報
ASP.NET ページのライフ サイクルの概要
Finalize メソッドおよびデストラクタ

Control.Dispose メソッド

Control によって使用されているすべてのリソースを解放します。
オーバーロードの一覧

名前	説明
Control.Dispose ()	Component によって使用されているすべてのリソースを解放します。
Control.Dispose (Boolean)	Control とその子コントロールが使用しているアンマネージ リソースを解放します。オプションで、マネージ リソースも解放します。 .NET Compact Framework によってサポートされています。

参照

関連項目

Control クラス
Control メンバ
System.Windows.Forms 名前空間