Partager via


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

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 :

Composants requis

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

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

  1. Dans le menu Fichier, créez un nouveau projet.

  2. Nommez le projet WindowsSearchForm.

  3. 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

  1. Dans le menu Données, cliquez sur Afficher les sources de données.

  2. 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.

  3. Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.

  4. 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).

  5. 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.

  6. Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.

  7. Développez le nœud Tables dans la page Choisir vos objets de base de données.

  8. 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

  1. Développez le nœud Customers dans la fenêtre Sources de données.

  2. 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

  1. Sélectionnez le contrôle DataGridView, puis choisissez Ajouter une requête dans le menu Données.

  2. Tapez FillByCity dans la zone Nouveau nom de requête sur le Générateur de critères de recherche, boîte de dialogue.

  3. 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 = ?.

  4. 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

  1. Appuyez sur F5 pour exécuter l'application.

  2. 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 :

Voir aussi

Référence

Vue d'ensemble du composant BindingSource

Vue d'ensemble du contrôle BindingNavigator (Windows Forms)

Concepts

Nouveautés du développement d'applications de données

Liaison de contrôles Windows Forms à des données dans Visual Studio

Vue d'ensemble des sources de données

Vue d'ensemble de TableAdapter

Autres ressources

Procédures pas à pas relatives aux données