Data Source Wizard Pages

• Oct 02, 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 WPF 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 that expose the wizard’s data source model functionality.

• Views

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

  The DevExpress.Xpf.DataAccess.DataSourceWizard 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	ChooseDataProviderPage

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	ChooseConnectionPage
Specify Connection Properties	ConnectionPropertiesPage<TModel>	IConnectionPropertiesPageView	ConnectionPropertiesPage
Save the Connection String	SaveConnectionPage<TModel>	ISaveConnectionPageView	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
  Create a Query or Select a Stored Procedure	MultiQueryConfigurePage<TModel> (Data Source Wizard) MultiQueryConfigurePage<TModel> (Report Wizard)	IMultiQueryConfigurePageView	MultiQueryConfigurePage
  Configure Query Parameters	MultiQueryConfigureParametersPage<TModel> (Data Source Wizard) MultiQueryConfigureParametersPageEx<TModel> (Report Wizard)	IMultiQueryConfigureParametersPageView	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
  Create a Query or Select a Stored Procedure (Obsolete)	ConfigureQueryPage<TModel> (Data Source Wizard) ConfigureQueryPageEx<TModel> (Report Wizard)	IConfigureQueryPageView	ConfigureQueryPage
  Configure Query Parameters	ConfigureSqlParametersPage<TModel> (Data Source Wizard) ConfigureSqlParametersPageEx<TModel> (Report Wizard)	IConfigureParametersPageView	ConfigureParametersPage

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
Select the Data Context	ChooseEFContextPage<TModel>	IChooseEFContextPageView	ChooseEFContextPage
Select a Connection String	ChooseEFConnectionStringPage<TModel> (Data Source Wizard) ChooseEFConnectionStringPageEx<TModel> (Report Wizard)	IChooseEFConnectionStringPageView	ChooseEFConnectionStringPage
Bind to a Stored Procedure	ConfigureEFStoredProceduresPage<TModel> (Data Source Wizard) ConfigureEFStoredProceduresPageEx<TModel> (Report Wizard)	IConfigureEFStoredProceduresPageView	ConfigureEFStoredProceduresPage
Select a Data Member	ChooseEFDataMemberPage<TModel> (Data Source Wizard) ChooseEFDataMemberPageEx<TModel> (Report Wizard)	IChooseEFDataMemberPageView	ChooseEFDataMemberPage
Configure Filters	ConfigureEFFiltersPage<TModel> (Data Source Wizard) ConfigureEFFiltersPageEx<TModel> (Report Wizard)	IConfigureEFFiltersPageView	ConfigureEFFiltersPage

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	ChooseObjectAssemblyPage
Select a Data Source Type	ChooseObjectTypePage<TModel> (Data Source Wizard) ChooseObjectTypePageEx<TModel> (Report Wizard)	IChooseObjectTypePageView	ChooseObjectTypePage
Select a Data Source Member	ChooseObjectMemberPage<TModel> (Data Source Wizard) ChooseObjectMemberPageEx<TModel> (Report Wizard)	IChooseObjectMemberPageView	ChooseObjectMemberPage
Specify the Member Parameters	ObjectMemberParametersPage<TModel> (Data Source Wizard) ObjectMemberParametersPageEx<TModel> (Report Wizard)	IObjectMemberParametersPageView	ObjectMemberParametersPage
Select the Data Binding Mode	ChooseObjectBindingModePage<TModel> (Data Source Wizard) ChooseObjectBindingModePageEx<TModel> (Report Wizard)	IChooseObjectBindingModePageView	ChooseObjectBindingModePage
Select a Data Source Constructor	ChooseObjectConstructorPage<TModel> (Data Source Wizard) ChooseObjectConstructorPageEx<TModel> (Report Wizard)	IChooseObjectConstructorPageView	ChooseObjectConstructorPage
Specify the Constructor Parameters	ObjectConstructorParametersPage<TModel> (Data Source Wizard) ObjectConstructorParametersPageEx<TModel> (Report Wizard)	IObjectConstructorParametersPageView	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
Select an Excel Workbook or CSV File	ChooseFilePage<TModel>	IChooseFilePageView	ChooseFilePage
Specify Import Settings	ChooseFileOptionsPage<TModel>	IChooseFileOptionsPageView	ChooseFileOptionsPage
Select a Worksheet, Table or Named Range	ChooseExcelFileDataRangePage<TModel>	IChooseExcelFileDataRangePageView	ChooseExcelFileDataRangePage
Choose Columns	ConfigureExcelFileColumnsPage<TModel> (Data Source Wizard) ConfigureExcelFileColumnsPageEx<TModel> (Report Wizard)	IConfigureExcelFileColumnsPageView	ConfigureExcelFileColumnsPage

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	ChooseJsonSourcePage
Select Data Fields	ChooseJsonSchemaPage<TModel> (Data Source Wizard) ChooseJsonSchemaPageEx<TModel> (Report Wizard)	IChooseJsonSchemaPageView	ChooseJsonSchemaPage

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	ChooseXPObjectSourceEntityTypePage
Select a Data Connection	ChooseXPObjectSourceConnectionPage<TModel> (Data Source Wizard) ChooseXPObjectSourceConnectionPageEx<TModel> (Report Wizard)	IChooseConnectionPageView	ChooseConnectionPage
Specify a Connection String	ConfigureXPObjectSourceConnectionPropertiesPage<TModel> (Data Source Wizard) ConfigureXPObjectSourceConnectionPropertiesPageEx<TModel> (Report Wizard)	IConnectionPropertiesPageView	ConnectionPropertiesPage
Save the Connection String	SaveXPObjectSourceConnectionPage<TModel> (Data Source Wizard) SaveXPObjectSourceConnectionPageEx<TModel> (Report Wizard)	ISaveConnectionPageView	SaveConnectionPage