Data Source Wizard Pages

• Oct 25, 2023
• 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 implementation.

All these pages are also included in the Report Wizard. This topic lists custom implementations of these pages that are specific 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 DevExpress.DataAccess.UI.Wizard.Views namespace contains default implementations of these interfaces.

• 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 store intermediate settings of a data source during wizard execution.

Start Page

Wizard Page	Page Presenter	Page View Interface	Page View
Select a Data Connection Type	ChooseDataProviderPage<TModel>	IChooseDataProviderPageView	ChooseDataProviderPageView

Connect to a Database

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

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

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
  Create a Query or Select a Stored Procedure	MultiQueryConfigurePage<TModel> (Data Source Wizard) MultiQueryConfigurePage<TModel> (Report Wizard)	IMultiQueryConfigurePageView	MultiQueryConfigurePageView
  Configure Query Parameters	MultiQueryConfigureParametersPage<TModel> (Data Source Wizard) MultiQueryConfigureParametersPageEx<TModel> (Report Wizard)	IMultiQueryConfigureParametersPageView	MultiQueryConfigureParametersPageView

• 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
  Create a Query or Select a Stored Procedure (Obsolete)	ConfigureQueryPage<TModel> (Data Source Wizard) ConfigureQueryPageEx<TModel> (Report Wizard)	IConfigureQueryPageView	ConfigureQueryPageView
  Configure Query Parameters	ConfigureSqlParametersPage<TModel> (Data Source Wizard) ConfigureSqlParametersPageEx<TModel> (Report Wizard)	IConfigureParametersPageView	ConfigureParametersPageView

Connect to an Entity Framework Data Source

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

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

Connect to an Object Data Source

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

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

Connect to an Excel Data Source

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

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

Connect to a JSON Data Source

The JsonDataSourceModel class stores intermediate settings of an XPO data source.

Wizard Page	Page Presenter	Page View Interface	Page View
Specify JSON Data Location	ChooseJsonSourcePage<TModel>	IChooseJsonSourcePageView	ChooseJsonSourcePageView
Select Data Fields	ChooseJsonSchemaPage<TModel> (Data Source Wizard) ChooseJsonSchemaPageEx<TModel> (Report Wizard)	IChooseJsonSchemaPageView	ChooseJsonSchemaPageView

Connect to an XPO Data Source

The XPObjectSourceModel class stores intermediate settings of an XPO data source.

Wizard Page	Page Presenter	Page View Interface	Page View
Choose an Entity Type	ChooseXPObjectSourceEntityTypePage<TModel>	IChooseXPObjectSourceEntityTypePageView	ChooseXPObjectSourceEntityTypePageView
Select a Data Connection	ChooseXPObjectSourceConnectionPage<TModel> (Data Source Wizard) ChooseXPObjectSourceConnectionPageEx<TModel> (Report Wizard)	IChooseConnectionPageView	ChooseConnectionPageView
Specify a Connection String	ConfigureXPObjectSourceConnectionPropertiesPage<TModel> (Data Source Wizard) ConfigureXPObjectSourceConnectionPropertiesPageEx<TModel> (Report Wizard)	IConnectionPropertiesPageView	ConnectionPropertiesPageView
Save the Connection String	SaveXPObjectSourceConnectionPage<TModel> (Data Source Wizard) SaveXPObjectSourceConnectionPageEx<TModel> (Report Wizard)	ISaveConnectionPageView	SaveConnectionPageView