Comment : Gérer les événements de données

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Vous pouvez personnaliser votre application en écrivant du code qui s'exécute lorsque certains événements de données se produisent. Par exemple, vous pouvez écrire du code qui s'exécute 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 du 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 en 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

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

  2. Dans la barre de commandes du Concepteur de données, cliquez sur la flèche en regard du bouton Écrire le code, puis sélectionnez une méthode à substituer. Les méthodes pouvant être gérées par votre application s'affichent dans les tableaux suivants.

    System_CAPS_ICON_note.jpg 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.

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

Les tableaux suivants répertorient les événements de données qui peuvent être gérés par votre application :

Méthodes généralesDescription
<TableName>_AllowSaveWithErrorsIndique 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>_CreatedAppelé après la création de l'élément. S'exécute sur la couche sur laquelle l'élément a été créé.
<TableSetName>_DeletedAppelé juste après la suppression de l'élément du magasin de données. S'exécute sur le serveur.
<TableSetName>_DeletingAppelé juste avant la suppression de l'élément du magasin de données. S'exécute sur le serveur.
<TableSetName>_InsertedAppelé juste après l'insertion de l'élément dans le magasin de données. S'exécute sur le serveur.
<TableSetName>_InsertingAppelé juste avant l'insertion de l'élément dans le magasin de données. S'exécute sur le serveur.
<TableSetName>_UpdatedAppelé juste après la mise à jour de l'élément dans le magasin de données. S'exécute sur le serveur.
<TableSetName>_UpdatingAppelé juste avant la mise à jour de l'élément dans le magasin de données. S'exécute sur le serveur.
<TableSetName>_ValidateAppelé lorsqu'un élément est validé sur le serveur.
Méthodes de contrôle d'accèsDescription
SaveChanges_CanExecuteAppelé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>_CanDeleteAppelé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>_CanInsertAppelé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>_CanReadAppelé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>_CanUpdateAppelé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êteDescription
Query_ExecuteFailedAppelée après l'échec d'exécution de la requête. S'exécute sur le serveur.
Query_ExecutedAppelé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.
Query_ExecutingAppelée juste avant d'exécuter la requête. S'exécute sur le serveur.
<TableSetName>_FilterAppelé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éesDescription
SaveChanges_ExecuteFailedAppelée immédiatement après l'échec d'enregistrement dans la source de données. S'exécute sur le serveur.
SaveChanges_ExecutedAppelé juste après l'enregistrement des modifications dans la source de données. S'exécute sur le serveur.
SaveChanges_ExecutingAppelé juste avant l'enregistrement des modifications dans la source de données. S'exécute sur le serveur.
Méthodes de propriété
<PropertyName>_ChangedAppelé 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>_IsReadOnlyRetourne une valeur indiquant si la propriété est en lecture seule. S'exécute sur la couche où la propriété est accessible.
<PropertyName>_ValidateAppelé lorsque la propriété est validée. S'exécute sur la couche sur laquelle la propriété est validée.

Données : les informations de votre application
Comment : gérer les événements d'écran Silverlight
Comment : Gérer les événements de requête

Afficher: