Partager via

Créer un Windows Form .NET Framework pour rechercher des données avec ADO.NET

Remarque

La DataSet classe et les classes associées sont des technologies .NET Framework héritées du début des années 2000 qui permettent aux applications d’utiliser des données en mémoire pendant que les applications sont déconnectées de la base de données. Les technologies sont particulièrement utiles pour les applications qui permettent aux utilisateurs de modifier les données et de conserver les modifications apportées à la base de données. Bien que les jeux de données soient une technologie éprouvée, l’approche recommandée pour les nouvelles applications .NET consiste à utiliser Entity Framework Core. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet et dispose d’une interface de programmation plus simple.

Un scénario d’application courant consiste à afficher les 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 ce scénario, un utilisateur entre des informations dans un formulaire, puis une requête est exécutée avec l’entrée de l’utilisateur en tant que paramètre ; autrement dit, les données sont sélectionnées en fonction d’une requête paramétrable. La requête retourne uniquement les données qui répondent aux critères entrés par l’utilisateur. Cette procédure pas à pas montre comment créer une requête qui retourne des clients dans une ville spécifique et modifier 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 de requêtes paramétrables permet d’optimiser l’efficacité de votre application en permettant à la base de données d’effectuer le travail le mieux possible , en filtrant rapidement les enregistrements. En revanche, si vous demandez une table de base de données entière, transférez-la sur le réseau, puis utilisez la logique d’application pour rechercher les enregistrements souhaités, votre application peut devenir lente et inefficace.

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

Les tâches illustrées dans cette procédure pas à pas sont les suivantes :

  • Création et configuration de la source de données dans votre application avec l’assistant de configuration Source de données.

  • Définition du type de déplacement des éléments dans la fenêtre Sources de données .

  • Création de contrôles qui affichent des données en faisant glisser des éléments de la fenêtre Sources de données vers un formulaire.

  • Ajout de contrôles pour afficher les données sur le formulaire.

  • Fin de la boîte de dialogue Générateur de critères de recherche .

  • Entrée de paramètres dans le formulaire et exécution de la requête paramétrable.

Remarque

Les procédures décrites dans cet article s’appliquent uniquement aux projets Windows Forms .NET Framework, et non aux projets Windows Forms .NET Core.

Conditions préalables

Le module Stockage et traitement des données doit être installé. Consultez Modifier Visual Studio.

Cette procédure pas à pas utilise SQL Server Express LocalDB et l’exemple de base de données Northwind.

  1. Si sql Server Express LocalDB n’est pas installé, installez-le à partir de la page de téléchargement SQL Server Express ou via Visual Studio Installer. Dans Visual Studio Installer, vous pouvez installer SQL Server Express LocalDB dans le cadre du stockage et du traitement des données charge de travail, ou en tant que composant individuel.

  2. Installez l’exemple de base de données Northwind en procédant comme suit :

    1. Dans Visual Studio, ouvrez la fenêtre de l’Explorateur d’objets SQL Server. (L’Explorateur d’objets SQL Server est installé dans le cadre de la charge de travail de stockage et de traitement des données dans Visual Studio Installer.) Développez le nœud SQL Server . Cliquez avec le bouton droit sur votre instance LocalDB, puis sélectionnez nouvelle requête.

      Une fenêtre de l’éditeur de requête s’ouvre.

    2. Copiez le script Northwind Transact-SQL dans votre presse-papiers. Ce script T-SQL crée la base de données Northwind à partir de zéro et la remplit avec des données.

    3. Collez le script T-SQL dans l’éditeur de requête, puis choisissez le bouton Exécuter.

      Après un court laps de temps, la requête se termine et la base de données Northwind est créée.

Créer l’application Windows Forms

Créez un projet d’application Windows Forms (.NET Framework) pour C# ou Visual Basic. Nommez le projet WindowsSearchForm.

Créer 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 la source de données :

  1. Pour ouvrir la fenêtre Sources de données , utilisez la recherche rapide (Ctrl+Q) et recherchez 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 la source de données .

  3. Sélectionnez base de données sur la page Choisir un type de source de données, puis sélectionnez Suivant.

  4. Dans l’écran Choisir un modèle de base de données , choisissez Dataset, puis sélectionnez Suivant.

  5. Dans la page Choisir votre connexion de données , effectuez l’une des opérations suivantes :

    • Si une connexion de données à l’échantillon de la base de données Northwind est disponible dans le menu déroulant, sélectionnez-la.

    • Sélectionnez Nouvelle connexion pour lancer la boîte de dialogue Ajouter/modifier la connexion .

  6. Dans la chaîne Enregistrer la connexion dans la page fichier configuration de l’application , cliquez sur Suivant.

  7. Dans la page Choisir vos objets de base de données , développez le nœud Tables .

  8. Sélectionnez la table Customers , puis sélectionnez Terminer.

    NorthwindDataSet est ajouté à votre projet, et la table Customers s’affiche dans la fenêtre Sources de données.

Créer le formulaire

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

  1. Vérifiez que le concepteur Windows Forms a le focus actif et que la fenêtre Sources de données est ouverte et épinglée.

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

  3. Faites glisser le nœud Clients de la fenêtre Sources de données vers votre formulaire.

    Une DataGridView et une barre d’outils (BindingNavigator) pour naviguer dans les enregistrements s’affichent sur le formulaire. Un NorthwindDataSet, CustomersTableAdapter, BindingSourceet BindingNavigator apparaît dans la barre d’état des composants.

Ajouter un paramétrage (fonctionnalité de recherche) à la requête

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

  1. Juste en dessous de l’aire de conception de votre formulaire, sélectionnez le bouton customersTableAdapter , puis, dans la fenêtre Propriétés , choisissez Ajouter une requête....

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

  3. Ajoutez WHERE City = @City à la requête dans la zone Texte de la requête .

    La requête doit être similaire à ce qui suit :

    SELECT CustomerID, CompanyName, ContactName, ContactTitle,
     Address, City, Region, PostalCode, Country, Phone, Fax
FROM Customers
WHERE City = @City

    Remarque

    Les sources de données Access et OLE DB utilisent le point d’interrogation (' ?') pour désigner les paramètres. Par conséquent, la WHERE clause se présente comme suit : WHERE City = ?.

  4. Cliquez sur OK pour fermer la boîte de dialogue Générateur de critères de recherche .

    Un FillByCityToolStrip est ajouté au formulaire.

Tester l’application

L’exécution de l’application ouvre votre formulaire et le prépare à prendre le paramètre comme entrée :

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

  2. Tapez Londres dans la zone de texte City , puis sélectionnez FillByCity.

    La grille de données est remplie avec les clients qui répondent aux critères. Dans cet exemple, la grille de données affiche uniquement les clients qui ont une valeur de Londres dans leur colonne City .

Étapes suivantes

Selon vos besoins en matière d’application, vous pouvez effectuer plusieurs étapes après la création d’un formulaire paramétrable. Voici quelques améliorations que vous pouvez apporter à cette procédure pas à pas :

Contenu connexe

  • Last updated on