Freigeben über


Form.Close-Methode

Schließt das Formular.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub Close
'Usage
Dim instance As Form

instance.Close
public void Close ()
public:
void Close ()
public void Close ()
public function Close ()

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Das Formular wurde geschlossen, während ein Handle erstellt wurde.

ObjectDisposedException

Sie können diese Methode nicht im Activated-Ereignis aufrufen, wenn WindowState auf Maximized festgelegt ist.

Hinweise

Wenn ein Formular geschlossen wird, werden alle im Objekt erstellten Ressourcen und das Formular freigegeben. Sie können das Schließen eines Formulars zur Laufzeit verhindern, indem Sie das Closing-Ereignis behandeln und die Cancel-Eigenschaft von CancelEventArgs, das als Parameter an den Ereignishandler übergeben wird, festlegen. Wenn das zu schließende Formular das Startformular der Anwendung ist, wird die Anwendung beendet.

Ein Formular wird ausschließlich dann bei Close nicht freigegeben, wenn es Teil einer MDI (Multiple Document Interface)-Anwendung ist und das Formular nicht angezeigt wird. In diesem Fall müssen Sie Dispose manuell aufrufen, um alle Steuerelemente des Formulars für die Garbage Collection zu kennzeichnen.

Hinweis

Wenn für eine als nicht modales Fenster angezeigte Form die Close-Methode aufgerufen wird, kann das Formular nicht wieder mit der Show-Methode angezeigt werden, da die Ressourcen des Formulars bereits freigegeben wurden. Zum Ausblenden eines Formulars und zum anschließenden Einblenden verwenden Sie die Control.Hide-Methode.

Warnung

Rufen Sie Close weder für das Load-Ereignis noch für das Activated-Ereignis aus einem Ereignishandler auf. In beiden Fällen können Speicherverluste entstehen. Verwenden Sie stattdessen das Idle-Ereignis, um zu testen, ob Sie ein Formular kurz nach dem Laden schließen müssen.

Warnung

Das Form.Closed-Ereignis und das Form.ClosingEreignis werden nicht ausgelöst, wenn zum Beenden der Anwendung die Application.Exit-Methode aufgerufen wird. Wenn in einem dieser beiden Ereignisse Validierungscode enthalten ist, der ausgeführt werden muss, sollten Sie die Form.Close-Methode für jedes Formular einzeln aufrufen, bevor die Exit-Methode aufgerufen wird.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Form-Klasse
Form-Member
System.Windows.Forms-Namespace
Cancel
Closing