Form.Close メソッド

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

Form.Close メソッド

フォームを閉じます。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub Close

Visual Basic (使用法)

Dim instance As Form

instance.Close

C#

public void Close ()

C++

public:
void Close ()

J#

public void Close ()

JScript

public function Close ()

例外

例外の種類	条件
InvalidOperationException	ハンドルが作成されている間にフォームが閉じました。
ObjectDisposedException	WindowState が Maximized に設定されている場合、このメソッドを Activated イベントから呼び出すことはできません。

解説

フォームが閉じると、オブジェクト内で作成されたすべてのリソースが閉じ、フォームが破棄されます。実行時にフォームを閉じないようにするには、Closing イベントを処理して、イベント ハンドラにパラメータとして渡される CancelEventArgs の Cancel プロパティを設定します。閉じているフォームがアプリケーションのスタートアップ フォームである場合は、アプリケーションが終了します。

特定の条件が満たされている場合は、Close でフォームが破棄されません。たとえば、フォームがマルチ ドキュメント インターフェイス (MDI) アプリケーションの一部として使用され、さらに、そのフォームが非表示にされている場合がこれに相当します。この場合は、フォーム上のすべてのコントロールをガベージ コレクションの対象としてマークするために、Dispose を直接呼び出す必要があります。

注意
Close は、Load イベントまたは Activated イベントのイベント ハンドラ内から呼び出さないでください。どちらの状況でもメモリ リークが発生する場合があります。フォームを起動直後に閉じる必要があるかどうかテストするには、代わりに Idle イベントを使用します。

注意
Application.Exit メソッドが呼び出されてアプリケーションを終了する場合、Form.Closed イベントと Form.Closing イベントは発生しません。これらのイベントのいずれかに実行する必要がある検証コードがある場合は、Exit メソッドを呼び出す前に、開いている各フォームに対して Form.Close メソッドを個別に呼び出す必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Form クラス
Form メンバ
System.Windows.Forms 名前空間
Cancel
Closing