Créer un Windows Form pour rechercher des donnéesCreate a Windows Form to search data

Un scénario d'application courant consiste à afficher les données sélectionnées dans un formulaire.A common application scenario is to display selected data on a form. Par exemple, supposons que vous souhaitiez afficher les commandes d'un client spécifique ou les détails d'une commande spécifique.For example, you might want to display the orders for a specific customer or the details of a specific order. 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.In this scenario, a user enters information into a form, and then a query is executed with the user's input as a parameter; that is, the data is selected based on a parameterized query. La requête retourne uniquement les données répondant aux critères entrés par l'utilisateur.The query returns only the data that satisfies the criteria entered by the user. 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.This walkthrough shows how to create a query that returns customers in a specific city, and modify the user interface so that users can enter a city's name and press a button to execute the query.

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.Using parameterized queries helps make your application efficient by letting the database do the work it is best at — quickly filtering records. En revanche, si vous demandez une table de base de données entière, transférez sur le réseau et ensuite utilisez logique d’application pour rechercher les enregistrements souhaités, votre application peut devenir lente et inefficace.In contrast, if you request an entire database table, transfer it over the network, and then use application logic to find the records you want, your application can become slow and inefficient.

Vous pouvez ajouter des requêtes paramétrables à n’importe quel TableAdapter (et contrôles pour accepter les valeurs de paramètre et exécuter la requête), à l’aide de la Générateur de critères de recherche boîte de dialogue.You can add parameterized queries to any TableAdapter (and controls to accept parameter values and execute the query), using the Search Criteria Builder dialog box. Ouvrez la boîte de dialogue en sélectionnant le ajouter une requête commande sur le données menu (ou sur toute balise active TableAdapter).Open the dialog box by selecting the Add Query command on the Data menu (or on any TableAdapter smart tag).

Cette procédure pas à pas décrit notamment les tâches suivantes :Tasks illustrated in this walkthrough include:

  • Création d’un nouveau Windows Forms Application projet.Creating a new Windows Forms Application project.

  • Création et configuration de la source de données dans votre application avec le Configuration de Source de données Assistant.Creating and configuring the data source in your application with the Data Source Configuration wizard.

  • Définissant le type de déplacement des éléments dans le des Sources de données fenêtre.Setting the drop type of the items in the Data Sources window.

  • Création de contrôles qui affichent des données en faisant glisser des éléments à partir de la des Sources de données fenêtre vers un formulaire.Creating controls that display data by dragging items from the Data Sources window onto a form.

  • Ajout de contrôles pour afficher les données dans le formulaire.Adding controls to display the data on the form.

  • Fin de la Générateur de critères de recherche boîte de dialogue.Completing the Search Criteria Builder dialog box.

  • Entrée de paramètres dans le formulaire et l’exécution de la requête paramétrable.Entering parameters into the form and executing the parameterized query.

PrérequisPrerequisites

Cette procédure pas à pas utilise SQL Server Express LocalDB et la base de données Northwind.This walkthrough uses SQL Server Express LocalDB and the Northwind sample database.

  1. Si vous n’avez pas SQL Server Express LocalDB, installez-le à partir de la page de téléchargement de SQL Server Express, ou via le le programme d’installation de Visual Studio.If you don't have SQL Server Express LocalDB, install it either from the SQL Server Express download page, or through the Visual Studio Installer. Dans le le programme d’installation de Visual Studio, vous pouvez installer SQL Server Express LocalDB dans le cadre de la stockage de données et de traitement charge de travail, ou comme un composant individuel.In the Visual Studio Installer, you can intall SQL Server Express LocalDB as part of the Data storage and processing workload, or as an individual component.

  2. Installer la base de données Northwind en suivant ces étapes :Install the Northwind sample database by following these steps:

    1. Dans Visual Studio, ouvrez le Explorateur d’objets SQL Server fenêtre.In Visual Studio, open the SQL Server Object Explorer window. (Explorateur d’objets SQL Server est installé dans le cadre de la stockage de données et de traitement charge de travail dans le le programme d’installation de Visual Studio.) Développez le SQL Server nœud.(SQL Server Object Explorer is installed as part of the Data storage and processing workload in the Visual Studio Installer.) Expand the SQL Server node. Avec le bouton droit sur votre instance de base de données locale et sélectionnez nouvelle requête.Right-click on your LocalDB instance and select New Query.

      Une fenêtre d’éditeur de requête s’ouvre.A query editor window opens.

    2. Copie le script Transact-SQL de Northwind dans votre Presse-papiers.Copy the Northwind Transact-SQL script to your clipboard. Ce script T-SQL crée la base de données Northwind à partir de zéro et la remplit avec des données.This T-SQL script creates the Northwind database from scratch and populates it with data.

    3. Collez le script T-SQL dans l’éditeur de requête, puis choisissez le Execute bouton.Paste the T-SQL script into the query editor, and then choose the Execute button.

      Après une courte période, la requête est terminée en cours d’exécution et la base de données Northwind est créé.After a short time, the query finishes running and the Northwind database is created.

Créer l’application Windows FormsCreate the Windows Forms application

La première étape consiste à créer un Windows Forms Application.The first step is to create a Windows Forms Application. Affectation d’un nom au projet est facultative à ce stade, mais vous devez lui donner un nom ici, car vous allez enregistrer le projet ultérieurement.Assigning a name to the project is optional at this step, but you'll give it a name here because you'll save the project later.

Pour créer le nouveau projet d’application Windows FormsTo create the new Windows Forms application project

  1. Dans Visual Studio, sur le fichier menu, sélectionnez New > projet.In Visual Studio, on the File menu, select New > Project.

  2. Développez le Visual C# ou Visual Basic dans le volet gauche, puis sélectionnez Windows Desktop.Expand either Visual C# or Visual Basic in the left-hand pane, then select Windows Desktop.

  3. Dans le volet central, sélectionnez le Windows Forms application type de projet.In the middle pane, select the Windows Forms App project type.

  4. Nommez le projet WindowsSearchForm, puis choisissez OK.Name the project WindowsSearchForm, and then choose OK.

    Le WindowsSearchForm projet est créé et ajouté à l’Explorateur de solutions.The WindowsSearchForm project is created and added to Solution Explorer.

Créer la source de donnéesCreate the data source

Cette étape crée une source de données à partir d’une base de données à l’aide de la Configuration de Source de données Assistant.This step creates a data source from a database using the Data Source Configuration wizard.

Pour créer la source de donnéesTo create the data source

  1. Dans le menu Données , cliquez sur Afficher les sources de données.On the Data menu, click Show Data Sources.

  2. Dans le des Sources de données fenêtre, sélectionnez ajouter une nouvelle Source de données pour démarrer le Configuration de Source de données Assistant.In the Data Sources window, select Add New Data Source to start the Data Source Configuration wizard.

  3. Sélectionnez Base de données dans la page Choisir un type de source de données , puis cliquez sur Suivant.Select Database on the Choose a Data Source Type page, and then click Next.

  4. Sur le choisir votre connexion de données page, procédez comme suit :On the Choose your Data Connection page do one of the following:

    • Si une connexion de données à l’exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.If a data connection to the Northwind sample database is available in the drop-down list, select it.

    • Sélectionnez nouvelle connexion pour lancer le Ajouter/modifier la connexion boîte de dialogue.Select New Connection to launch the Add/Modify Connection dialog box.

  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.If your database requires a password, select the option to include sensitive data, and then click Next.

  6. Sur le enregistrer la chaîne de connexion dans le fichier de Configuration de l’Application , cliquez sur suivant.On the Save connection string to the Application Configuration file page, click Next.

  7. Sur le choisir vos objets de base de données page, développez le Tables nœud.On the Choose your Database Objects page, expand the Tables node.

  8. Sélectionnez le clients table, puis cliquez sur Terminer.Select the Customers table, and then click Finish.

    Le NorthwindDataSet est ajouté à votre projet et le clients table s’affiche dans le des Sources de données fenêtre.The NorthwindDataSet is added to your project, and the Customers table appears in the Data Sources window.

Création d’un formulaireCreate the form

Vous pouvez créer les contrôles liés aux données en faisant glisser des éléments à partir de la des Sources de données fenêtre vers votre formulaire.You can create the data-bound controls by dragging items from the Data Sources window onto your form.

Pour créer des contrôlés liés aux données dans le formulaireTo create data-bound controls on the form

  1. Développez le clients nœud dans le des Sources de données fenêtre.Expand the Customers node in the Data Sources window.

  2. Faites glisser le clients nœud à partir de la des Sources de données fenêtre à votre formulaire.Drag the Customers node from the Data Sources window to your form.

    Un DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent sur le formulaire.A DataGridView and a tool strip (BindingNavigator) for navigating records appear on the form. Un NorthwindDataSet, CustomersTableAdapter, BindingSource, et BindingNavigator s’affichent dans la barre d’état du composant.A NorthwindDataSet, CustomersTableAdapter, BindingSource, and BindingNavigator appear in the component tray.

Ajoutez le paramétrage (fonctionnalité de recherche) à la requêteAdd parameterization (search functionality) to the query

Vous pouvez ajouter une clause WHERE à la requête d’origine en utilisant le Générateur de critères de recherche boîte de dialogue.You can add a WHERE clause to the original query using the Search Criteria Builder dialog box.

Pour créer une requête paramétrable et des contrôles pour entrer les paramètresTo create a parameterized query and controls to enter the parameters

  1. Sélectionnez le DataGridView contrôler, puis choisissez ajouter une requête sur le données menu.Select the DataGridView control, and then choose Add Query on the Data menu.

  2. Type FillByCity dans le nouveau nom de requête zone sur le Générateur de critères de recherche boîte de dialogue.Type FillByCity in the New query name area on the Search Criteria Builder dialog box.

  3. Ajouter WHERE City = @City à la requête dans le texte de la requête zone.Add WHERE City = @City to the query in the Query Text area.

    La requête doit ressembler à la suivante :The query should be similar to the following:

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

    Note

    Les sources de données Access et OleDb utilisent le point d’interrogation (« ? ») pour indiquer les paramètres, par conséquent, la clause WHERE ressemblerait à ceci : WHERE City = ?.Access and OLE DB data sources use the question mark ('?') to denote parameters, so the WHERE clause would look like this: WHERE City = ?.

  4. Cliquez sur OK pour fermer la Générateur de critères de recherche boîte de dialogue.Click OK to close the Search Criteria Builder dialog box.

    Un FillByCityToolStrip est ajouté au formulaire.A FillByCityToolStrip is added to the form.

Test de l'applicationTesting the application

Exécution de l’application ouvre votre formulaire et le rend prêt à utiliser le paramètre en tant qu’entrée.Running the application opens your form and makes it ready to take the parameter as input.

Pour tester l'applicationTo test the application

  1. Appuyez sur F5 pour exécuter l’application.Press F5 to run the application.

  2. Type Londres dans le Ville zone de texte, puis cliquez sur FillByCity.Type London into the City text box, and then click FillByCity.

    La grille de données est remplie avec les clients qui répondent aux critères.The data grid is populated with customers that meet the criteria. Dans cet exemple, la grille de données affiche uniquement les clients qui ont une valeur de Londres dans leurs Ville colonne.In this example, the data grid only displays customers that have a value of London in their City column.

Étapes suivantesNext steps

Selon les exigences de votre application, vous pouvez exécuter différentes étapes après la création d’un formulaire paramétrable.Depending on your application requirements, there are several steps you may want to perform after creating a parameterized form. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :Some enhancements you could make to this walkthrough include:

Voir aussiSee also