Procédure pas à pas : application de requête paramétrée

Article
08/21/2008

Mise à jour : novembre 2007

Cette procédure pas à pas vous montre comment utiliser l'environnement Visual Studio pour développer une application de requête paramétrable simple. La liaison de données et la plupart des procédures de l'interface utilisateur sont générées automatiquement pour vous. En se basant sur la base de données Northwind familière, cette application prévoit le scénario où les utilisateurs de projets Smart Device doivent déterminer le pays d'envoi (Shipping Country) lorsqu'ils connaissent uniquement le numéro de commande (Order Number). Les applications que vous générez ici prévoient la saisie par l'utilisateur du numéro de commande (Order Number) et l'affichage du pays d'envoi (Shipping Country) correspondant.

Remarque :
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Cette procédure pas à pas a été écrite à l'aide des Paramètres de développement Visual Basic et des Paramètres de développement Visual C#.

Composants requis

La base de données Northwind pour SQL Server Compact 3.5, incluse dans Visual Studio.

Remarque :
Si vous n'avez pas la qualité d'administrateur sur votre ordinateur de développement, vous ne pouvez pas ouvrir le fichier Northwind.sdf à son emplacement par défaut, lecteur:\Program Files\Microsoft SQL Server Compact Edition\v3.5\Samples. Copiez le fichier sur le bureau ou dans Mes documents et ouvrez-le à cet endroit lorsque vous y êtes invité.

Choix d'un appareil cible

La procédure suivante permet d'afficher un message vous invitant à sélectionner un appareil lorsque vous déployez une solution.

Pour être invité à sélectionner l'appareil cible au moment du déploiement

Dans le menu Outils, cliquez sur Options, développez Outils d'appareils, puis cliquez sur Général.
Activez la case à cocher Afficher les choix d'appareils avant de déployer un projet Smart Device.

Création de l'application

Il s'agit d'une application Windows Forms simple destinée à héberger les fonctionnalités de données de cette procédure pas à pas.

Pour créer un projet Windows Forms Smart Device

(Visual Basic) Dans le menu Fichier de Visual Studio, cliquez sur Nouveau projet.

- ou -

(Visual C#) Dans le menu Fichier de Visual Studio, pointez sur Nouveau, puis cliquez sur Projet.
Dans le volet Types de projets, développez Visual Basic ou Visual C#, cliquez sur Smart Device, cliquez sur Projet Smart Device dans le volet Modèles, tapez ParamQuerySample dans la zone Nom, puis cliquez sur OK.
Dans la boîte de dialogue Ajoutez un nouveau projet Smart Device, sélectionnez Pocket PC 2003 dans le menu déroulant Plateforme cible, cliquez sur Application Smart Device, puis cliquez sur OK.

La représentation d'un appareil Pocket PC apparaît dans le Concepteur Windows Forms.

Ajout de fonctionnalités de données

Cette procédure pas à pas se compose des tâches suivantes :

Sélection d'un type de source de données.
Sélection et configuration d'une connexion de données.
Sélection d'objets de base de données.
Ajout des contrôles liés aux données sur le formulaire.

Pour sélectionner un type de source de données

Dans le menu Données, cliquez sur Ajouter une nouvelle source de données pour lancer l'Assistant Configuration de source de données.
Dans la page Choisir un type de source de données, cliquez sur Base de données, puis sur Suivant.

Pour sélectionner et configurer une connexion de données

Dans la page Choisir votre connexion de données, cliquez sur Nouvelle connexion.

Dans la boîte de dialogue Choisir la source de données, cliquez sur Microsoft SQL Server Compact 3.5, puis sur Continuer.

Remarque :
Selon les paramètres et les projets antérieurs, la boîte de dialogue Ajouter une connexion peut s'afficher à la place de la boîte de dialogue Choisir la source de données. Si cela se produit, cliquez sur Modifier dans la boîte de dialogue Ajouter une connexion pour ouvrir la boîte de dialogue Modifier la source de données. Sélectionnez ensuite Microsoft SQL Server Compact 3.5, puis cliquez sur OK.

Selon les paramètres et les projets antérieurs, la boîte de dialogue Ajouter une connexion peut s'afficher à la place de la boîte de dialogue Choisir la source de données. Si cela se produit, cliquez sur Modifier dans la boîte de dialogue Ajouter une connexion pour ouvrir la boîte de dialogue Modifier la source de données. Sélectionnez ensuite Microsoft SQL Server Compact 3.5, puis cliquez sur OK.

Dans la boîte de dialogue Ajouter une connexion, sélectionnez Poste de travail.
Dans la boîte de dialogue Ajouter une connexion, cliquez sur Parcourir.
Dans la boîte de dialogue Sélectionner le fichier de base de données SQL Server Compact 3.5, sélectionnez Northwind.sdf, puis cliquez sur Ouvrir.
Dans la boîte de dialogue Ajouter une connexion, laissez la zone Mot de passe vide.

Cette base de données n'a aucun mot de passe.

Note de sécurité :

Utilisez un mot de passe fort pour les bases de données utilisées dans les applications réelles.

Note de sécurité :
Utilisez un mot de passe fort pour les bases de données utilisées dans les applications réelles.

Cliquez sur Tester la connexion pour vérifier la connexion.

Remarque :
Si l'accès au fichier Northwind.sdf est refusé, copiez le fichier sur le bureau et naviguez jusqu'à cette copie pour l'ouvrir. Cette situation peut se produire si vous n'avez pas de droits suffisants sur l'ordinateur de développement pour ouvrir le fichier dans son emplacement par défaut, répertorié au début de cette procédure pas à pas.

Cliquez sur OK dans le message qui affiche que la connexion est réussie, puis cliquez sur OK pour fermer la boîte de dialogue Ajouter une connexion.
Dans la page Choisir votre connexion de données, cliquez sur Suivant.
Dans le message qui demande si vous souhaitez copier le fichier vers votre projet, cliquez sur Oui.

Pour sélectionner des objets de base de données

Dans la page Choisir vos objets de base de données, développez le nœud Tables, puis activez la table Orders.
Cliquez sur Terminer.

Le contrôle NorthwindDataset est créé. Vous pouvez consulter cette source de données en cliquant sur Afficher les sources de données dans le menu Données.

Pour créer la requête

Dans la fenêtre Sources de données, développez la table Orders.
Cliquez sur la colonne Ship Country, cliquez sur la flèche de déroulement, puis sélectionnez l'option Label.
Faites glisser la colonne Ship Country sur le formulaire du concepteur.
Sur le contrôle label dans le concepteur, cliquez sur la balise active, puis sur Ajouter une requête.
Dans la boîte de dialogue Générateur de critères de recherche, sélectionnez Générateur de requêtes.
Dans la colonne Filter de la ligne Order ID, tapez un point d'interrogation (?).

Ce symbole indique que les utilisateurs de l'application doivent entrer une valeur pour l'ID de commande.
Cliquez sur OK.

La clause WHERE dans la zone Texte de la requête doit indiquer maintenant ([Order ID]=@PARAM1).
Cliquez sur OK pour fermer la boîte de dialogue Générateur de critères de recherche.

Un écran lié à la requête apparaît sur le formulaire du concepteur.

Pour affiner l'interface utilisateur

Cliquez avec le bouton droit sur le contrôle label PARAM1 dans le concepteur, puis cliquez sur Propriétés.

- ou -

Sélectionnez le contrôle Param1Label dans la fenêtre Propriétés.
Remplacez la propriété Text par Order ID.
Sélectionnez le bouton FillBy, puis remplacez sa propriété Text par Show country.
Développez le panneau et les contrôles pour éliminer les barres de défilement et afficher tout le texte. Apportez une attention toute particulière au fait que Ship_CountryLabel et sa zone de texte ne soient pas masqués derrière FillByPanel et ses contrôles.

Test de l'application

Dans cette section, vous pouvez générer l'application, télécharger l'émulateur du Pocket PC 2003 SE et vérifier que l'application fonctionne correctement.

Pour tester l'application

Dans le menu Déboguer, cliquez sur Démarrer ou Démarrer le débogage.
Dans la boîte de dialogue Déployer, sélectionnez Pocket PC 2000 SE - émulateur, puis cliquez sur Déployer.

La progression du déploiement apparaît dans la barre d'état. Le déploiement vers l'émulateur peut prendre du temps.
Lorsque l'application s'exécute sur l'émulateur, tapez un numéro de commande de 10000 à 11077 dans la base de données Northwind, puis cliquez sur Show country.

Le pays d'envoi (Ship Country) correspondant à cette commande s'affiche dans le contrôle label.

Préparation de procédures pas à pas supplémentaires

Si vous projetez de créer des procédures pas à pas supplémentaires ou d'ouvrir d'autres projets, vous pouvez arrêter l'émulateur et quitter cette solution.

Pour fermer l'émulateur et la solution

Dans le menu Fichier, cliquez sur Quitter.
Dans la zone de message Device Emulator, cliquez sur Non en réponse au message qui vous demande si vous souhaitez enregistrer l'état de l'émulateur.
(Visual Basic) Dans le menu Fichier, cliquez sur Fermer le projet.

- ou -

(Visual C#) Dans le menu Fichier, cliquez sur Fermer la solution.

Si vous êtes invité à enregistrer le projet ou la solution, cliquez sur Enregistrer si vous souhaitez l'utiliser ultérieurement ; sinon, cliquez sur Abandonner pour que vos fichiers ne soient pas enregistrés.

Voir aussi