Boutons de commande du carnet d'adresses

Article
11/09/2018

L’application Carnet d’adresses inclut les boutons de commande suivants :

Un bouton de recherche pour soumettre une requête à la base de données.
Un bouton Effacer pour effacer les zones de texte avant de commencer une nouvelle recherche.
Un bouton Mettre à jour le profil pour enregistrer les modifications apportées à une fiche d'employé.
Un bouton Annuler les modifications pour ignorer les modifications.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers le service de données WCF .

Bouton Rechercher

En cliquant sur le bouton Rechercher, cela active la sous-procédure VBScript Find_OnClick, qui génère et envoie la requête SQL. Cliquez sur ce bouton pour remplir la grille de données.

Génération de la requête SQL

La première partie de la procédure Find_OnClick Sub génère la requête SQL, une expression à la fois, en ajoutant des chaînes de texte à une instruction SQL SELECT globale. Elle commence par définir la variable myQuery sur une instruction SQL SELECT qui demande toutes les lignes de données de la table de source de données. Ensuite, la sous-procédure analyse chacune des quatre zones d’entrée de la page.

Étant donné que le programme utilise le mot like lors de la création des instructions SQL, les requêtes sont des recherches de sous-chaînes plutôt que des correspondances exactes.

Par exemple, si la zone Nom de famille contenait l’entrée « Berge » et la zone Titre contenait l’entrée « Program Manager », l’instruction SQL (valeur de myQuery) lirait :

Select FirstName, LastName, Title, Email, Building, Room, Phone from Employee where lastname like 'Berge%' and title like 'Program Manager%'

Si la requête a réussi, toutes les personnes portant un nom contenant le texte « Berge » (par exemple, Berge et Berger) et avec un titre contenant les mots « Program Manager » (par exemple, Program Manager, Advanced Technologies) sont affichées dans la grille de données HTML.

Préparation et envoi de la requête

La dernière partie de la procédure Find_OnClick Sub se compose de deux instructions. La première instruction affecte la propriété SQL de l'objet RDS.DataControl à la requête SQL générée dynamiquement. La deuxième instruction provoque le RDS. DataControl objet (DC1) pour interroger la base de données, puis afficher les nouveaux résultats de la requête dans la grille.

Sub Find_OnClick  
   '...  
   DC1.SQL = myQuery  
   DC1.Refresh  
End Sub

Bouton Mettre à jour le profil

Le fait de cliquer sur le bouton Mettre à jour le profil active la procédure Sub Update_OnClick en VBScript, qui exécute les méthodes SubmitChanges et Refresh de l'objet RDS.DataControl (DC1).

Sub Update_OnClick  
   DC1.SubmitChanges  
   DC1.Refresh  
End Sub

Lorsque DC1.SubmitChanges s’exécute, le service de données distant empaquette toutes les informations de mise à jour et les envoie au serveur via HTTP. La mise à jour est tout ou rien ; si une partie de la mise à jour échoue, aucune des modifications n’est apportée et un message d’état est retourné. DC1.Refresh n'est pas nécessaire après SubmitChanges avec le Remote Data Service (RDS), mais il garantit des données fraîches.

Bouton Annuler les modifications

Cliquer sur Annuler les modifications active la procédure VBScript Cancel_OnClick Sub, qui exécute le RDS. DataControl objet (DC1)Méthode CancelUpdate.

Sub Cancel_OnClick  
   DC1.CancelUpdate  
End Sub

Lorsque DC1.CancelUpdate s’exécute, il ignore toutes les modifications qu’un utilisateur a apportées à un enregistrement d’employé sur la grille de données depuis la dernière requête ou mise à jour. Elle restaure les valeurs d’origine.

Voir aussi

boutons de navigation du carnet d’adresses
Objet DataControl (RDS)

Partager via