Comment : Gérer les événements de données
Vous pouvez personnaliser votre application par écriture de code qui s'exécute lorsque certains événements de données se produisent.Par exemple, vous pouvez écrire le code qui s'exécutera lors de la création, l'accès, la modification ou la suppression de lignes de données dans une table.Vous pouvez également écrire le code pour vérifier qu'un utilisateur a l'autorisation de modifier la source de données.
Les événements que vous pouvez gérer peuvent être regroupés dans six catégories :
Méthodes générales exécutées lorsque les données sont créées, supprimées ou modifiées.
Méthodes de contrôle d'accès exécutées lorsque les données sont créées, supprimées ou modifiées.
Méthodes de requête exécutées lorsqu'une source de données est interrogée.
Méthodes de source de données exécutées lorsqu'une source de données est enregistrée.
Méthodes de propriété exécutées lorsqu'une propriété est modifiée.
Une description de ces méthodes s'affiche dans les tables à la fin de cette rubrique.
Pour gérer un événement lié à des données
Dans l'Explorateur de solutions, double-cliquez sur une entité ou une table.
L'entité ou la table s'ouvre dans le Concepteur de données.
Dans la barre de commandes du Concepteur de données, cliquez sur la flèche en regard du bouton Écrire le code et sélectionnez une méthode que vous voulez substituer.Les méthodes pouvant être gérées par votre application s'affichent dans les tableaux suivants.
[!REMARQUE]
Les Méthodes de propriété ne s'afficheront dans la liste déroulante Écrire le code que si une propriété est sélectionnée dans le Concepteur de données.
L'Éditeur de code s'ouvre.
Placez votre curseur dans la méthode que vous venez de créer et tapez le code que vous voulez exécuter lorsque l'événement se produit.
Liste d'événements liés aux données
Les tableaux suivants répertorient les événements de données qui peuvent être gérés par votre application :
Méthodes générales |
Description |
|---|---|
<TableName>_AllowSaveWithErrors |
Indique si l'élément doit être enregistré s'il contient des erreurs de validation.L'enregistrement est annulé par défaut si l'élément comporte des erreurs de validation.S'exécute sur la couche appelante. |
<TableName>_Created |
Appelé après la création de l'élément.S'exécute sur la couche sur laquelle l'élément a été créé. |
<TableSetName>_Deleted |
Appelé juste après la suppression de l'élément du magasin de données.S'exécute sur le serveur. |
<TableSetName>_Deleting |
Appelé juste avant la suppression de l'élément du magasin de données.S'exécute sur le serveur. |
<TableSetName>_Inserted |
Appelé juste après l'insertion de l'élément dans le magasin de données.S'exécute sur le serveur. |
<TableSetName>_Inserting |
Appelé juste avant l'insertion de l'élément dans le magasin de données.S'exécute sur le serveur. |
<TableSetName>_Updated |
Appelé juste après la mise à jour de l'élément dans le magasin de données.S'exécute sur le serveur. |
<TableSetName>_Updating |
Appelé juste avant la mise à jour de l'élément dans le magasin de données.S'exécute sur le serveur. |
<TableSetName>_Validate |
Appelé lorsqu'un élément est validé sur le serveur. |
Méthodes de contrôle d'accès |
Description |
|---|---|
SaveChanges_CanExecute |
Appelée avant l'enregistrement des modifications dans la source de données pour vérifier le niveau d'autorisation de l'utilisateur actuel.S'exécute sur le serveur. |
<TableSetName>_CanDelete |
Appelée avant la suppression d'un élément pour vérifier le niveau d'autorisation de l'utilisateur actuel.S'exécute sur le serveur. |
<TableSetName>_CanInsert |
Appelée avant l'insertion d'un élément pour vérifier le niveau d'autorisation de l'utilisateur actuel.S'exécute sur le serveur. |
<TableSetName>_CanRead |
Appelée avant la lecture d'un élément pour vérifier le niveau d'autorisation de l'utilisateur actuel.S'exécute sur le serveur. |
<TableSetName>_CanUpdate |
Appelée avant la mise à jour d'un élément pour vérifier le niveau d'autorisation de l'utilisateur actuel.S'exécute sur le serveur. |
Méthode de requête |
Description |
|---|---|
Query_ExecuteFailed |
Appelée après l'échec d'exécution de la requête.S'exécute sur le serveur. |
Query_Executed |
Appelée immédiatement après avoir exécuté la requête.Cette méthode n'est pas appelée si la requête ne peut pas s'exécuter.S'exécute sur le serveur. |
Exécution de la requête. |
Appelée juste avant d'exécuter la requête.S'exécute sur le serveur. |
<TableSetName>_Filter |
Appelée avant l'exécution de la requête, ce qui permet une personnalisation de requête supplémentaire.S'exécute sur le serveur. |
Méthodes de source de données |
Description |
|---|---|
SaveChanges_ExecuteFailed |
Appelée immédiatement après l'échec d'enregistrement dans la source de données.S'exécute sur le serveur. |
SaveChanges_Executed |
Appelé juste après l'enregistrement des modifications dans la source de données.S'exécute sur le serveur. |
SaveChanges_Executing |
Appelé juste avant l'enregistrement des modifications dans la source de données.S'exécute sur le serveur. |
Méthodes de propriétés |
|
|---|---|
<PropertyName>_Changed |
Appelé juste après la modification de la valeur d'un élément.S'exécute sur la couche sur laquelle la propriété a été modifiée. |
<PropertyName>_IsReadOnly |
Retourne une valeur indiquant si la propriété est en lecture seule.S'exécute sur la couche où la propriété est accessible. |
<PropertyName>_Validate |
Appelé lorsque la propriété est validée.S'exécute sur la couche sur laquelle la propriété est validée. |
Voir aussi
Tâches
Comment : gérer les événements d'écran Silverlight
Comment : Gérer les événements de requête