Form.BeforeInsert-Ereignis (Access)

Das BeforeInsert-Ereignis tritt auf, wenn der Benutzer das erste Zeichen in einem neuen Datensatz eingibt, aber bevor der Datensatz tatsächlich erstellt wird.

Syntax

Ausdruck. BeforeInsert (Abbrechen)

expression Eine Variable, die ein Form-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Abbrechen	Erforderlich	Integer	Durch die Einstellung wird bestimmt, ob das BeforeInsert-Ereignis auftritt. Wenn Sie das Cancel-Argument auf True (1) festlegen, wird das BeforeInsert-Ereignis abgebrochen.

Hinweise

Hinweis

Diese Ereignisse werden nicht ausgelöst, wenn der Wert eines Steuerelements mithilfe eines Makros oder mithilfe von Visual Basic festgelegt wird.

Um ein Makro oder eine Ereignisprozedur auszuführen, wenn diese Ereignisse auftreten, legen Sie die BeforeInsert - oder AfterInsert-Eigenschaft auf den Namen des Makros oder auf [Ereignisprozedur] fest.

Verwenden Sie eine AfterInsert-Ereignisprozedur oder ein Makro, um ein Recordset erneut abzuabfragen, wenn ein neuer Datensatz hinzugefügt wird.

Die Ereignisse BeforeInsert und AfterInsert ähneln den Ereignissen BeforeUpdate und AfterUpdate . Diese Ereignisse treten in der folgenden Reihenfolge ein:

BeforeInsert → BeforeUpdate → AfterUpdate → AfterInsert

In der folgenden Tabelle wird die Interaktion zwischen diesen Ereignissen dargestellt.

Ereignis	Tritt auf
BeforeInsert	Wenn der Benutzer das erste Zeichen in einen neuen Datensatz eingibt.
BeforeUpdate	Wenn der Benutzer den Datensatz aktualisiert.
AfterUpdate	Wenn der Datensatz aktualisiert ist.
AfterInsert	Wenn der aktualisierte Datensatz ein neuer Datensatz ist.

Wenn das erste Zeichen in einem neuen Datensatz in ein Textfeld oder Kombinationsfeld eingegeben wird, tritt das BeforeInsert-Ereignis vor dem Change-Ereignis auf.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie eine BeforeInsert-Ereignisprozedur verwenden können, um zu überprüfen, ob der Benutzer einen neuen Datensatz erstellen möchte, und eine AfterInsert-Ereignisprozedur , um die Datensatzquelle für das Employees-Formular erneut abzurufen, nachdem ein Datensatz hinzugefügt wurde.

Um das Beispiel auszuprobieren, fügen Sie die folgende Ereignisprozedur zu einem Formular mit dem Namen Employees hinzu, das auf einer Tabelle oder Abfrage basiert. Wechseln Sie zur Datenblattansicht des Formulars, und versuchen Sie, einen Datensatz einzufügen.

Private Sub Form_BeforeInsert(Cancel As Integer) 
 If MsgBox("Insert new record here?", _ 
 vbOKCancel) = vbCancel Then 
 Cancel = True 
 End If 
End Sub 
 
Private Sub Form_AfterInsert() 
 Forms!Employees.Requery 
End Sub

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.