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 |
---|---|
Das Formular wurde geschlossen, während ein Handle erstellt wurde. |
|
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