Create a Windows Form to search data

A common application scenario is to display selected data on a form. For example, you might want to display the orders for a specific customer or the details of a specific order. 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. The query returns only the data that satisfies the criteria entered by the user. 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.

Using parameterized queries helps make your application efficient by letting the database do the work it is best at — quickly filtering records. 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.

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. Open the dialog box by selecting the Add Query command on the Data menu (or on any TableAdapter smart tag).

Tasks illustrated in this walkthrough include:

• Creating a new Windows Forms Application project.

• Creating and configuring the data source in your application with the Data Source Configuration wizard.

• Setting the drop type of the items in the Data Sources window.

• Creating controls that display data by dragging items from the Data Sources window onto a form.

• Adding controls to display the data on the form.

• Completing the Search Criteria Builder dialog box.

• Entering parameters into the form and executing the parameterized query.

Prerequisites

In order to complete this walkthrough, you need:

• Access to the Northwind sample database.

Create the Windows Application

The first step is to create a Windows Application. Assigning a name to the project is optional at this step, but you'll give it a name here because you'll save it later.

To create the new Windows Application project

1. From the File menu, create a new project.

2. Name the project WindowsSearchForm.

3. Select Windows Application and click OK.

   The WindowsSearchForm project is created and added to Solution Explorer.

Create the data source

This step creates a data source from a database using the Data Source Configuration wizard. You must have access to the Northwind sample database to create the connection. For information on setting up the Northwind sample database, see Install SQL Server sample databases.

To create the data source

1. On the Data menu, click Show Data Sources.

2. In the Data Sources window, select Add New Data Source to start the Data Source Configuration wizard.

3. Select Database on the Choose a Data Source Type page, and then click Next.

4. On the Choose your Data Connection page do one of the following:

   • If a data connection to the Northwind sample database is available in the drop-down list, select it.

   • Select New Connection to launch the Add/Modify Connection dialog box.

5. If your database requires a password, select the option to include sensitive data, and then click Next.

6. On the Save connection string to the Application Configuration file page, click Next.

7. On the Choose your Database Objects page, expand the Tables node.

8. Select the Customers table, and then click Finish.

   The NorthwindDataSet is added to your project, and the Customers table appears in the Data Sources window.

Create the form

You can create the data-bound controls by dragging items from the Data Sources window onto your form.

To create data-bound controls on the form

1. Expand the Customers node in the Data Sources window.

2. Drag the Customers node from the Data Sources window to your form.

   A DataGridView and a tool strip (BindingNavigator) for navigating records appear on the form. A NorthwindDataSet, CustomersTableAdapter, BindingSource, and BindingNavigator appear in the component tray.

Addparameterization (search functionality) to the query

You can add a WHERE clause to the original query using the Search Criteria Builder dialog box.

To create a parameterized query and controls to enter the parameters

1. Select the DataGridView control, and then choose Add Query on the Data menu.

2. Type FillByCity in the New query name area on the Search Criteria Builder dialog box.

3. Add WHERE City = @City to the query in the Query Text area.

   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

   Access and OLE DB data sources use the question mark ('?') to denote parameters, so the WHERE clause would look like this: WHERE City = ?.

4. Click OK to close the Search Criteria Builder dialog box.

   A FillByCityToolStrip is added to the form.

Testing the application

Running the application opens your form ready to take the parameter as input.

To test the application

1. Press F5 to run the application.

2. Type London into the City text box, and then click FillByCity.

   The data grid is populated with customers that meet the criteria. In this example, the data grid only displays customers that have a value of London in their City column.

Next Steps

Depending on your application requirements, there are several steps you may want to perform after creating a parameterized form. Some enhancements you could make to this walkthrough include:

• Adding controls that display related data.

• Editing the dataset to add or remove database objects. For more information, see Create and configure datasets.

See Also

Bind Windows Forms controls to data in Visual Studio