Procédure pas à pas : création d'un Windows Form pour rechercher des données

Article
08/10/2011

Un scénario d'application courant consiste à afficher des données sélectionnées sur un formulaire. Par exemple, vous pouvez afficher les commandes d'un client spécifique ou les détails d'une commande spécifique. Dans un tel scénario, l'utilisateur entre des informations dans un formulaire, et une requête est ensuite exécutée avec comme paramètre les données entrées par l'utilisateur (autrement dit, les données sont sélectionnées sur la base d'une requête paramétrée). La requête retourne uniquement les données qui répondent aux critères entrés par l'utilisateur. Cette procédure pas à pas indique comment créer une requête qui retourne des clients dans une ville spécifique, et modifie l'interface utilisateur afin que les utilisateurs puissent entrer le nom d'une ville et appuyer sur un bouton pour exécuter la requête.

L'utilisation des requêtes paramétrées améliore l'efficacité de votre application dans la mesure où vous laissez la base de données faire ce qu'elle fait le mieux, à savoir filtrer des enregistrements. À l'inverse, si vous demandez une table de base de données entière, la transférez via le réseau, puis utilisez la logique de l'application pour rechercher les enregistrements souhaités, votre application risque de devenir lente et difficile à manipuler.

Vous pouvez ajouter des requêtes paramétrables à TableAdapter (et des contrôles pour accepter des valeurs de paramètre et exécuter la requête) à l'aide de Générateur de critères de recherche, boîte de dialogue. Ouvrez la boîte de dialogue en sélectionnant la commande Ajouter une requête dans le menu Données (ou sur toute balise active TableAdapter).

Cette procédure pas à pas illustre les tâches suivantes :

Création d'un nouveau projet Application Windows.
Création et configuration de la source de données dans votre application avec le Configuration de source de données (Assistant).
Définition du type de déplacement des éléments dans Sources de données (fenêtre). Pour plus d'informations, consultez Comment : définir le contrôle à créer lors d'une opération de glisser-déplacer à partir de la fenêtre Sources de données.
Création de contrôles qui affichent des données en faisant glisser des éléments depuis la fenêtre Sources de données jusqu'à un formulaire.
Ajout de contrôles pour afficher les données sur le formulaire.
Compléter le Générateur de critères de recherche, boîte de dialogue.
Saisie des paramètres dans le formulaire et exécution de la requête paramétrée.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez :

avoir accès à l'exemple de base de données Northwind. Pour plus d'informations, consultez Comment : installer des exemples de bases de données.

Création de l'application Windows

La première étape consiste à créer une Application Windows. L'assignation d'un nom au projet est facultative à ce stade, mais nous lui donnerons un nom, car nous avons l'intention de l'enregistrer ultérieurement.

Pour créer le nouveau projet Application Windows

Dans le menu Fichier, créez un nouveau projet.
Nommez le projet WindowsSearchForm.
Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

Le projet WindowsSearchForm est créé et ajouté à l'Explorateur de solutions.

Création de la source de données

Cette étape crée une source de données à partir d'une base de données à l'aide de l'Assistant Configuration de source de données. Vous devez avoir accès à l'exemple de base de données Northwind pour créer la connexion. Pour plus d'informations sur l'installation de l'exemple de base de données Northwind, consultez Comment : installer des exemples de bases de données.

Pour créer la source de données

Dans le menu Données, cliquez sur Afficher les sources de données.
Dans la fenêtre Sources de données, sélectionnez Ajouter une nouvelle source de données pour démarrer l'Assistant Configuration de source de données.
Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.
Dans la page Choisir votre connexion de données, effectuez l'une des opérations suivantes :
- Si une connexion de données à l'exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.
  
  ou
- Sélectionnez Nouvelle connexion pour afficher la boîte de dialogue Ajouter/Modifier la connexion. Pour plus d'informations, consultez Ajouter/Modifier une connexion, boîte de dialogue (Général).
Si votre base de données requiert un mot de passe, sélectionnez l'option pour inclure les données sensibles, puis cliquez sur Suivant.
Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.
Développez le nœud Tables dans la page Choisir vos objets de base de données.
Sélectionnez la table Customers, puis cliquez sur Terminer.

NorthwindDataSet est ajouté à votre projet et la table Customers apparaît dans la fenêtre Sources de données.

Création du formulaire

Vous pouvez créer les contrôles liés aux données en faisant glisser des éléments depuis la fenêtre Sources de données vers votre formulaire.

Pour créer des contrôles liés aux données sur le formulaire

Développez le nœud Customers dans la fenêtre Sources de données.
Faites glisser le nœud Customers depuis la fenêtre Sources de données jusqu'à votre formulaire.

Un DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent sur le formulaire. Un NorthwindDataSet, un CustomersTableAdapter, un BindingSource et un BindingNavigator apparaissent dans la barre d'état des composants.

Ajout du paramétrage (fonctionnalité de recherche) à la requête

Vous pouvez ajouter une clause WHERE à la requête d'origine à l'aide du Générateur de critères de recherche, boîte de dialogue.

Pour créer une requête paramétrée et des contrôles permettant d'entrer les paramètres

Sélectionnez le contrôle DataGridView, puis choisissez Ajouter une requête dans le menu Données.
Tapez FillByCity dans la zone Nouveau nom de requête sur le Générateur de critères de recherche, boîte de dialogue.
Ajoutez WHERE City = @City à la requête dans la zone Texte de la requête.

La requête doit se présenter sous la forme suivante :

SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax

FROM Customers

WHERE City = @City

Notes

Les sources de données Access et OleDb utilisent le point d'interrogation « ? » pour indiquer les paramètres ; la clause WHERE se présente donc sous la forme suivante : WHERE City = ?.
Cliquez sur OK pour fermer la boîte de dialogue Générateur de critères de recherche.

FillByCityToolStrip est ajouté au formulaire.

Test de l'application

L'exécution de l'application ouvre votre formulaire prêt à prendre le paramètre comme d'entrée.

Pour tester l'application

Appuyez sur F5 pour exécuter l'application.
Tapez London dans la zone de texte Ville, puis cliquez sur FillByCity.

La grille de données est remplie avec les clients qui répondent aux critères de paramétrage. Dans cet exemple, la grille de données affiche uniquement les clients dont la colonne Ville a la valeur London.

Étapes suivantes

Selon les exigences de votre application, vous pouvez exécuter différentes étapes après la création d'un formulaire paramétré. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :

Ajout de contrôles qui affichent des données connexes. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.
Modification du groupe de données pour ajouter ou supprimer des objets de base de données. Pour plus d'informations, consultez Comment : modifier un groupe de données.

Voir aussi

Partager via