Événement Form.BeforeInsert (Access)

L'événement BeforeInsert se produit lorsque l'utilisateur tape le premier caractère dans un nouvel enregistrement, mais avant la création effective de l'enregistrement.

Syntaxe

expression. BeforeInsert (Cancel)

expressionVariable qui représente un objetForm.

Parameters

Nom	Requis/Facultatif	Type de données	Description
Cancel	Obligatoire	Integer	Le paramètre détermine si l'événement BeforeInsert se produit. La définition de l’argument Cancel sur True (1) annule l’événement BeforeInsert .

Remarques

Remarque

[!REMARQUE] La définition de la valeur d'un contrôle à l'aide d'une macro ou de Visual Basic ne déclenche pas ces événements.

Pour exécuter une macro ou une procédure événementielle lorsque ces événements se produisent, définissez la propriété BeforeInsert ou AfterInsert sur le nom de la macro ou sur [Procédure événementielle].

Utilisez une macro ou une procédure événementielle AfterInsert pour réexécuter un jeu d’enregistrements chaque fois qu’un nouvel enregistrement est ajouté.

Les événements BeforeInsert et AfterInsert sont similaires aux événements BeforeUpdate et AfterUpdate . Ils se produisent dans l'ordre suivant :

BeforeInsert → BeforeUpdate → AfterUpdate → AfterInsert

Le tableau suivant vous montre comment ces événements agissent les uns avec les autres :

Événement	Survient lorsque
BeforeInsert	L'utilisateur tape le premier caractère d'un nouvel enregistrement.
BeforeUpdate	L'utilisateur met à jour l'enregistrement.
AfterUpdate	L'enregistrement est mis à jour.
AfterInsert	L'enregistrement mis à jour est un nouvel enregistrement.

Si le premier caractère d’un nouvel enregistrement est tapé dans une zone de texte ou une zone de liste déroulante, l’événement BeforeInsert se produit avant l’événement Change .

Exemple

Cet exemple montre comment utiliser une procédure événementielle BeforeInsert pour vérifier que l’utilisateur souhaite créer un enregistrement, et une procédure événementielle AfterInsert pour réexécuter la source d’enregistrement pour le formulaire Employés après l’ajout d’un enregistrement.

Pour essayer l’exemple, ajoutez la procédure événementielle suivante à un formulaire nommé Employés basé sur une table ou une requête. Basculez en mode Feuille de données de formulaire et essayez d'insérer un enregistrement.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.