Invoke and Customize the Query Builder

Nov 10, 2025
6 minutes to read

This document describes how to integrate the Query Builder without using the Data Source Wizard in which it is used initially.

Important

Customization options described in this help topic are available to owners of DevExpress WinForms, DXperience, and Universal subscriptions (subscriptions that include DevExpress WinForms UI Controls). The DevExpress Reporting Subscription does not support UI customization in Report Viewer or End-User Report Designer. You can use ReportPrintTool and ReportDesignTool classes to display Print Preview and End-User Report Designer in their default configurations.

Refer to the following help topic for information on subscription options: Installation - Subscriptions that Include Reporting Components.

Invoke the Query Builder

Use the following SqlDataSourceUIHelper class methods to invoke the Query Builder in a WinForms application:

These methods’ parameters include a QueryBuilderEditQueryContext instance and a custom QueryBuilderRunner implementation that define various Query Builder options.

View Example: Reporting for WinForms - Query Builder

Customize the Query Builder

This document section describes how to replace the Query Builder with a custom dialog in a Data Source Wizard:

The Create a Query or Select a Stored Procedure (Multi-Query Version) wizard page initializes and displays the standard Query Builder dialog.

Do the following to substitute the Query Builder with a custom dialog:

Override the RunQueryBuilder virtual method of this page’s presenter (MultiQueryConfigurePage<TModel>).
Implement the IWizardCustomizationService interface to register a custom query configuration form.
Add the custom services to the Report Designer by calling the XRDesignMdiController.AddService method at the application’s startup.