É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.