DoCmd.Close-Methode (Access)

Die Methode Close führt die "Close"-Aktion in Visual Basic aus.

Syntax

expression.Close (ObjectType, ObjectName, Save)

expression Eine Variable, die ein DoCmd-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
ObjectType	Optional	AcObjectType	Eine AcObjectType-Konstante, die den Typ des zu schließenden Objekts darstellt.
ObjectName	Optional	Variant	Ein Zeichenfolgenausdruck, der der gültige Name eines Objekts vom Typ ist, der durch das Argument ObjectType ausgewählt wurde.
Save	Optional	AcCloseSave	Eine AcCloseSave-Konstante, die angibt, ob Änderungen am Objekt gespeichert werden sollen. Der Standardwert lautet acSavePrompt.

Bemerkungen

Verwenden Sie die Close -Methode, um entweder ein angegebenes Microsoft Access-Fenster oder das aktive Fenster zu schließen, wenn keins angegeben ist.

Wenn Sie die Argumente ObjectType und ObjectName leer lassen (die standardmäßige Konstante, acDefault, wird für ObjectType übernommen), schließt Access das aktive Fenster. Wenn Sie das Argument Save angeben und die Argumente ObjectType und ObjectName leer lassen, müssen Sie die Kommas der Argumente ObjectType und ObjectName einschließen.

Hinweis

Wenn ein Formular über ein Steuerelement verfügt, das an ein Feld gebunden ist, dessen Eigenschaft Required auf "Yes" festgelegt ist und das Formular mit der Methode Close geschlossen wird, ohne dass Daten für dieses Feld eingegeben werden, wird keine Fehlermeldung angezeigt. Alle Änderungen an den Datensatz werden abgebrochen. Wenn das Formular unter Verwendung der Benutzeroberfläche geschlossen wird, zeigt Access eine Warnung an.

Verwenden Sie zum Anzeigen einer Fehlermeldung die Methode RunCommand, um den Befehl acCmdSaveRecord aufzurufen, bevor die Methode Close aufgerufen wird. Dies verursacht einen Laufzeitfehler, wenn mindestens ein erforderliches Feld Null aufweist. Diese Technik wird im folgenden Beispiel veranschaulicht.

Private Sub cmdCloseForm_Click() 
On Error GoTo Err_cmdCloseForm_Click 
 
 DoCmd.RunCommand acCmdSaveRecord 
 DoCmd.Close 
 
Exit_cmdCloseForm_Click: 
 Exit Sub 
 
Err_cmdCloseForm_Click: 
 MsgBox Err.Description 
 Resume Exit_cmdCloseForm_Click 
 
End Sub

Beispiel

Im folgenden Beispiel wird die Methode Close zum Schließen des Formulars Order Review verwendet, wobei Änderungen am Formular ohne Bestätigung vorgenommen werden.

DoCmd.Close acForm, "Order Review", acSaveYes

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.