Data Source Wizard Pages

• Dec 27, 2021
• 4 minutes to read

This document lists pages included in the Data Source Wizard along with classes defining presenters and page views corresponding to WinForms and WPF implementations.

All these pages are also included in the Report Wizard. This topic lists custom implementations of these pages wired specifically to the Report Wizard logic.

Wizard Structural Elements

The structural elements of the Data Source Wizard conform to the MVP (model-view-presenter) pattern and are set out in the following namespaces:

• Models

  The DevExpress.DataAccess.Wizard.Model namespace contains interfaces and classes providing the data source model functionality for the wizard.

• Views

  The DevExpress.DataAccess.Wizard.Views namespace contains interfaces identifying wizard page views.

  The following namespaces contain default implementations of these interfaces depending on your application’s target platform:

  • WinForms: DevExpress.DataAccess.UI.Wizard.Views

    The Report Wizard uses custom implementation for some of the views contained in the DevExpress.XtraReports.Wizards.Views namespace.

  • WPF: DevExpress.Xpf.DataAccess.DataSourceWizard

• Presenters

  The DevExpress.DataAccess.Wizard.Presenters namespace contains Data Source Wizard page presenters.

  The Report Wizard uses custom implementation for some of the presenters contained in the DevExpress.XtraReports.Wizards.Presenters namespace.

The following document sections describe presenters and views corresponding to specific Data Source Wizard pages as well as classes that accumulate intermediate settings of a data source during wizard execution.

Start Page

Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
Select the Data Source Type	ChooseDataSourceTypePage	IChooseDataSourceTypePageView	ChooseDataSourceTypePageView	ChooseDataSourceTypePage

Connect to a Database

The SqlDataSourceModel class accumulates intermediate settings of a SQL data source.

Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
Select a Data Connection	ChooseConnectionPage<TModel>	IChooseConnectionPageView	ChooseConnectionPageView	ChooseConnectionPage
Specify a Connection String	ConnectionPropertiesPage<TModel>	IConnectionPropertiesPageView	ConnectionPropertiesPageView	ConnectionPropertiesPage
Save the Connection String	SaveConnectionPage<TModel>	ISaveConnectionPageView	SaveConnectionPageView	SaveConnectionPage

Wizard pages may vary depending on the wizard implementation your application uses.

• The following wizard pages correspond to the default wizard implementation, which allows you to create multiple queries in one wizard run and create master-detail relationships at once:

  Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
  Create a Query or Select a Stored Procedure (Multi-Query Version)	MultiQueryConfigurePage<TModel> (Data Source Wizard) MultiQueryConfigurePage<TModel> (Report Wizard)	IMultiQueryConfigurePageView	MultiQueryConfigurePageView	MultiQueryConfigurePage
  Configure Query Parameters	MultiQueryConfigureParametersPage<TModel> (Data Source Wizard) MultiQueryConfigureParametersPageEx<TModel> (Report Wizard)	IMultiQueryConfigureParametersPageView	MultiQueryConfigureParametersPageView	MultiQueryConfigureParametersPage

• The pages listed below correspond to the older wizard implementation where it is only possible to create a single query in one wizard run.

  Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
  Create a Query or Select a Stored Procedure (Single-Query Version)	ConfigureQueryPage<TModel> (Data Source Wizard) ConfigureQueryPageEx<TModel> (Report Wizard)	IConfigureQueryPageView	ConfigureQueryPageView	ConfigureQueryPage
  Configure Query Parameters	ConfigureSqlParametersPage<TModel> (Data Source Wizard) ConfigureSqlParametersPageEx<TModel> (Report Wizard)	IConfigureParametersPageView	ConfigureParametersPageView	ConfigureParametersPage

  To learn how to switch back to the older Report Wizard version, see the following examples online:

  • WinForms: How to switch the Report Wizard to a single-query version
  • WPF: How to switch the Report Wizard to a single-query version

Connect to an Entity Framework Data Source

The EFDataSourceModel class accumulates intermediate settings of an Entity Framework data source.

Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
Select the Data Context	ChooseEFContextPage<TModel>	IChooseEFContextPageView	ChooseEFContextPageView	ChooseEFContextPage
Select a Connection String	ChooseEFConnectionStringPage<TModel> (Data Source Wizard) ChooseEFConnectionStringPageEx<TModel> (Report Wizard)	IChooseEFConnectionStringPageView	ChooseEFConnectionStringPageView	ChooseEFConnectionStringPage
Specify a Connection String	ConfigureEFConnectionStringPage<TModel> (Data Source Wizard) ConfigureEFConnectionStringPageEx<TModel> (Report Wizard)	IConfigureEFConnectionStringPageView	ConfigureEFConnectionStringPageView	ConfigureEFConnectionStringPage
Bind to a Stored Procedure	ConfigureEFStoredProceduresPage<TModel> (Data Source Wizard) ConfigureEFStoredProceduresPageEx<TModel> (Report Wizard)	IConfigureEFStoredProceduresPageView	ConfigureEFStoredProceduresPageView	ConfigureEFStoredProceduresPage
Select a Data Member	ChooseEFDataMemberPage<TModel> (Data Source Wizard) ChooseEFDataMemberPageEx<TModel> (Report Wizard)	IChooseEFDataMemberPageView	ChooseEFDataMemberPageView	ChooseEFDataMemberPage
Configure Filters	ConfigureEFFiltersPage<TModel> (Data Source Wizard) ConfigureEFFiltersPageEx<TModel> (Report Wizard)	IConfigureEFFiltersPageView	ConfigureEFFiltersPageView	ConfigureEFFiltersPage

Connect to an Object Data Source

The ObjectDataSourceModel class accumulates intermediate settings of an object data source.

Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
Select an Assembly	ChooseObjectAssemblyPage<TModel>	IChooseObjectAssemblyPageView	ChooseObjectAssemblyPageView	ChooseObjectAssemblyPage
Select a Data Source Type	ChooseObjectTypePage<TModel> (Data Source Wizard) ChooseObjectTypePageEx<TModel> (Report Wizard)	IChooseObjectTypePageView	ChooseObjectTypePageView	ChooseObjectTypePage
Select a Data Source Member	ChooseObjectMemberPage<TModel> (Data Source Wizard) ChooseObjectMemberPageEx<TModel> (Report Wizard)	IChooseObjectMemberPageView	ChooseObjectMemberPageView	ChooseObjectMemberPage
Specify the Member Parameters	ObjectMemberParametersPage<TModel> (Data Source Wizard) ObjectMemberParametersPageEx<TModel> (Report Wizard)	IObjectMemberParametersPageView	ObjectMemberParametersPageView	ObjectMemberParametersPage
Select the Data Binding Mode	ChooseObjectBindingModePage<TModel> (Data Source Wizard) ChooseObjectBindingModePageEx<TModel> (Report Wizard)	IChooseObjectBindingModePageView	ChooseObjectBindingModePageView	ChooseObjectBindingModePage
Select a Data Source Constructor	ChooseObjectConstructorPage<TModel> (Data Source Wizard) ChooseObjectConstructorPageEx<TModel> (Report Wizard)	IChooseObjectConstructorPageView	ChooseObjectConstructorPageView	ChooseObjectConstructorPage
Specify the Constructor Parameters	ObjectConstructorParametersPage<TModel> (Data Source Wizard) ObjectConstructorParametersPageEx<TModel> (Report Wizard)	IObjectConstructorParametersPageView	ObjectConstructorParametersPageView	ObjectConstructorParametersPage

Connect to an Excel Data Source

The ExcelDataSourceModel class accumulates intermediate settings of an Excel data source.

Wizard Page	Page Presenter	Page View Interface	Page View (WinForms)	Page View (WPF)
Select an Excel Workbook or CSV File	ChooseFilePage<TModel>	IChooseFilePageView	ChooseFilePageView	ChooseFilePage
Specify Import Settings	ChooseFileOptionsPage<TModel>	IChooseFileOptionsPageView	ChooseFileOptionsPageView	ChooseFileOptionsPage
Select a Worksheet, Table or Named Range	ChooseExcelFileDataRangePage<TModel>	IChooseExcelFileDataRangePageView	ChooseExcelFileDataRangePageView	ChooseExcelFileDataRangePage
Choose Columns	ConfigureExcelFileColumnsPage<TModel> (Data Source Wizard) ConfigureExcelFileColumnsPageEx<TModel> (Report Wizard)	IConfigureExcelFileColumnsPageView	ConfigureExcelFileColumnsPageView	ConfigureExcelFileColumnsPage