Back to Devexpress

Connect to a Database

dashboard-401400-web-dashboard-create-dashboards-on-the-web-providing-data-create-a-new-data-source-specify-data-source-settings-database.md

latest3.9 KB
Original Source

Connect to a Database

  • Jan 05, 2026
  • 2 minutes to read

Prerequisites

Prerequisites

  1. Register a data connection string provider.

  2. Install a database provider if necessary.

For information on supported databases and required providers, refer to the following help topic: Supported Data Providers.

Select a Data Connection

The Choose a data connection page appears if you select Database on the start page. Select an existing connection from the list.

For information on how to register data connections in your application, refer to the following help topics:

Choose Queries

The next page allows you to create/edit a query or select a stored procedure. The image below displays a generated query in the SQL string editor.

Click Run Query Builder… to launch the Query Builder and choose the tables/columns visually.

Configure Query Parameters

If the SQL query contains query parameters, click Next to configure them.

You can use the following approaches to specify a parameter value:

  • Assign a static value

  • Provide a dynamic parameter value

Click Finish to create a new data source.

API

The database wizard pages are identified by the following API:

Page NamePage IDClass
Choose Connection (Database)SqlDataSourceWizardPageId.ChooseConnectionPageChooseSqlConnectionPage
Choose QueriesSqlDataSourceWizardPageId.ConfigureQueryPageConfigureQueryPage
Configure Query ParametersSqlDataSourceWizardPageId.ConfigureParametersPageConfigureQueryParametersPage
Choose Queries (a multi-query version)SqlDataSourceWizardPageId.MultiQueryConfigurePageMultiQueryConfigurePage
Configure Query Parameters (a multi-query version)SqlDataSourceWizardPageId.MultiQueryConfigureParametersPageMultiQueryConfigureParametersPage

See Also

Create a JSON Data Source

Create an OLAP Data Source