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

Article
06/10/2015

Un scénario d'application courant consiste à afficher les données sélectionnées dans un formulaire. Par exemple, supposons que vous souhaitiez afficher les commandes d'un client spécifique ou les détails d'une commande spécifique. Dans ce scénario, un utilisateur entre des informations dans un formulaire, puis une requête est exécutée prenant l'entrée de l'utilisateur comme paramètre. C'est-à-dire que les données sont sélectionnées selon une requête paramétrable. La requête retourne uniquement les données répondant aux critères entrés par l'utilisateur. Cette procédure pas à pas indique comment créer une requête retournant les clients d'une ville spécifique et modifier l'interface utilisateur de sorte que les utilisateurs puissent entrer un nom de ville et appuyer sur un bouton pour exécuter la requête.

L'utilisation des requêtes paramétrables renforce l'efficacité de votre application en utilisant la base de données de la meilleure manière possible : pour filtrer rapidement des enregistrements. À l'inverse, si vous interrogez une table de base de données entière, que vous la transférer sur le réseau et que vous utilisez la logique d'application pour trouver les enregistrements souhaités, votre application peut devenir lente et perdre en efficacité.

Vous pouvez ajouter des requêtes paramétrables à n'importe quel TableAdapter (et aux contrôles permettant d'accepter les valeurs de paramètre et d'exécuter la requête) à l'aide de la 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 dans n'importe quelle balise active de TableAdapter).

Cette procédure pas à pas décrit notamment les tâches suivantes :

Création d'un projet d'application Windows.
Création et configuration d'une source de données dans votre application à l'aide de l'Configuration de source de données (Assistant).
Définition du type de déplacement des éléments dans la 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 affichant les données en faisant glisser des éléments depuis la fenêtre Sources de données vers un formulaire.
Ajout de contrôles pour afficher les données dans le formulaire.
Utilisation de la Générateur de critères de recherche, boîte de dialogue.
Entrée de paramètres dans le formulaire et exécution de la requête paramétrable.

Composants requis

Pour exécuter cette procédure pas à pas, vous avez besoin des éléments suivants :

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'attribution d'un nom au projet est facultative à ce stade, mais nous allons lui en donner un car nous avons l'intention de l'enregistrer ultérieurement.

Pour créer le projet d'application Windows

Dans le menu Fichier, créez un nouveau projet.
Attribuez le nom WindowsSearchForm au projet.
Sélectionnez Application Windows et cliquez sur OK. Pour plus d'informations, consultez Développement d'applications clientes.

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 la configuration 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.
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

Pour créer des contrôles liés aux données, vous pouvez faire glisser des éléments depuis la fenêtre Sources de données vers votre formulaire.

Pour créer des contrôlés liés aux données dans 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 vers votre formulaire.

Un DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent sur le formulaire. NorthwindDataSet, CustomersTableAdapter, BindingSource et BindingNavigator s'affichent 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 de la Générateur de critères de recherche, boîte de dialogue.

Pour créer une requête paramétrable et des contrôles pour 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 Nom de la nouvelle requête de la 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 ressembler à la 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 désigner des paramètres, la clause WHERE sera donc de type : WHERE City = ?.
Cliquez sur OK pour fermer la boîte de dialogue Générateur de critères de recherche.

Un FillByCityToolStrip est ajouté au formulaire.

Test de l'application

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

Pour tester l'application

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

La grille de données est remplie avec les clients correspondant aux critères du paramétrage. Dans cet exemple, la grille de données n'affiche que les clients possédant une valeur London dans leur colonne City.

Étapes suivantes

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

Ajout de contrôles affichant les données associées. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.
Modification du dataset 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