Comment : gérer les événements d'écran Silverlight
Vous pouvez personnaliser votre application par écriture de code qui s'exécute lorsque certains événements se produisent.Par exemple, vous pouvez écrire le code qui s'exécute avant que les données soient enregistrées dans une source de données.
Les événements que vous pouvez gérer peuvent être regroupés dans quatre catégories :
Méthodes de bouton appelées lors d'un clic sur un bouton.
Méthodes générales appelées lorsque les données sont chargées ou enregistrées, ou lorsqu'un écran est fermé.
Méthodes de contrôle d'accès appelées pour vérifier si un utilisateur a l'autorisation d'effectuer une tâche.
Méthodes de collection appelées lorsqu'une collection 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 d'écran
Pour ouvrir l'écran que vous voulez modifier, double-cliquez sur celui-ci dans l'Explorateur de solutions.
Le Concepteur d'écran s'ouvre.
En haut du Concepteur d'écran, cliquez sur la flèche en regard du bouton Écrire le code, puis sélectionnez une méthode.Les méthodes auxquelles vous pouvez ajouter du code personnalisé s'affichent dans les tables ci-dessous.
L'éditeur de code s'ouvre.
[!REMARQUE]
Les Méthodes de collection s'affichent seulement dans la liste déroulante Écrire le code si la collection est sélectionnée dans le volet de données de gauche du Concepteur d'écran.
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 de méthodes d'événement d'écran
Le tableau suivant répertorie des méthodes d'événement associées à l'écran.Toutes ces méthodes sont exécutées sur la couche Client.
Méthodes de bouton |
Description |
|---|---|
<MyMethodName>_Execute |
Appelé à la suite d'un clic sur le bouton associé à la méthode. |
Méthodes générales |
Description |
|---|---|
<ScreenName>_Activated |
Appelée immédiatement après qu'un écran a été activé. |
<ScreenName>_Closing |
Appelé juste avant la fermeture de l'écran. |
<ScreenName>_Created |
Appelée immédiatement après que l'écran s'est affiché. |
<ScreenName>_InitializeDataWorkspace |
Appelé juste avant la récupération des données d'écran. |
<ScreenName>_Run |
Appelé après une demande d'affichage de l'écran. |
<ScreenName>_SaveError |
Appelé lorsqu'une tentative d'enregistrement de l'écran génère une erreur. |
<ScreenName>_Saved |
Appelée immédiatement après que l'écran a été enregistré. |
<ScreenName>_Saving |
Appelé juste avant l'enregistrement de l'écran. |
Méthodes de contrôle d'accès |
Description |
|---|---|
CanRun<ScreenName> |
Appelée avant qu'un écran s'affiche.LightSwitch appelle cette méthode pour vérifier les autorisations de l'utilisateur actuel. |
<MyMethodName>_CanExecute |
Appelée avant qu'une méthode s'exécute.LightSwitch appelle cette méthode pour vérifier les autorisations de l'utilisateur actuel. |
Méthodes de collection |
Description |
|---|---|
<CollectionName>_Changed |
Appelée immédiatement après que la collection a été modifiée. |
<CollectionName>_SelectionChanged |
Appelé juste après la sélection de l'élément actuellement sélectionné dans la collection. |
Voir aussi
Tâches
Comment : Gérer les événements de données
Comment : Gérer les événements de requête
Concepts
Écriture de code dans LightSwitch
Comment : modifier un écran Silverlight à l'aide du code