Événement OnSave de grille (référence de l’API client)
L’événement OnSave
se produit avant d’envoyer les informations actualisées au serveur et, lorsque l’un des éléments suivants survient :
- Il existe un changement dans la sélection d’enregistrements.
- L’utilisateur déclenche explicitement une opération d’enregistrement à l’aide du bouton d’enregistrement de la grille modifiable.
- L’utilisateur applique une opération de tri, filtre, groupe, pagination, ou de navigation dans la grille modifiable lorsqu’il existe des modifications en attente.
Voici quelques remarques importantes concernant l’événement OnSave
:
- Si un utilisateur modifie plusieurs colonnes du même enregistrements en séquence, l’événement OnSave sera uniquement déclenché une fois pour garantir des performances optimales et la compatibilité du comportement du formulaire.
- La grille modifiable et le formulaire parent ont des boutons d’enregistrement distincts. La sélection du bouton Enregistrer pour l’un ne sauvegardera pas les modifications pour l’autre.
- La grille modifiable n’enregistre pas les modifications en instance lorsque des opérations de navigation sont effectuées en dehors de son contexte. Si le contrôle contient des données non enregistrées, ces données peuvent être perdues. Par conséquent, l’événement
OnSave
ne peut pas se déclencher. Par exemple, cela peut se produire lors de la navigation vers un enregistrement différent à l’aide d’une colonne de recherche de formulaire ou via le ruban. - La sélection du bouton d’actualisation dans la grille modifiable entraîne l’annulation de toutes les modifications en attente, et l’événement
OnSave
ne sera pas déclenché. - Le contrôle de la grille modifiable n’implémente pas de délai d’expiration de sauvegarde automatique. La grille modifiable supprime les règles de détection des doublons.
Notes
L’événement OnSave
pour les enregistrements de rendez-vous, de rendez-vous périodique ou d’activité de service annulera l’opération d’enregistrement et utilisera le message Book
pour conserver la modification au lieu de Create
ou Update
. De ce fait, les gestionnaires d’événements OnSave
et PostSave
pour ces tables ne fonctionneront pas.
Article associé
Événement OnSave de formulaire
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : pendant toute l’année 2024, nous allons éliminer progressivement Problèmes GitHub comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, voir :Soumettre et afficher des commentaires pour