[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
   [Expand]Product Information
    Product Structure
    Getting Started
   [Expand]Spreadsheet Document
    Supported Formats
   [Expand]Cell Basics
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
    Data Grouping
   [Expand]Pivot Tables
   [Expand]Charts and Graphics
   [Collapse]Mail Merge
     Mail Merge Ribbon Tab
     Mail Merge Design View
     Field List Panel
     Parameters Panel
     Data Source Wizard
     Mail Merge Functions
     Template Document
    Operation Restrictions
    Find and Replace
   [Expand]Visual Elements
   [Expand]Keyboard Shortcuts
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Parameters Panel

The Parameters panel allows the user to fine-tune a mail-merge report by providing a required parameter. To create a panel, click the SpreadsheetControl's smart tag and select Create Parameters Panel in the invoked SpreadsheetControl Tasks menu.

To create a parametrized query, you can use the built-in Query Builder dialog, as shown below.

  • In the External Data Sources group, select Manage Queries from the Manage Relations drop-down menu.

    In the Manage Queries dialog, click the ellipsis button in the query list to edit the selected query.

  • In the invoked Query Editor window, click the Run Query Builder... button.

    In the Query Builder window, click Filter ...

    ... to invoke the Filter Editor dialog, which allows you to specify a filtering criterion to be applied to the source data.

  • Click OK to close the Filter Editor dialog, and then click OK to close the Query Builder window.

  • Click Next in the Query Editor dialog to navigate to the page that allows you to configure query parameters. This page is shown in the image below.

    Select the check box in the Expression column to specify an expression to calculate the parameter value. Map the query parameter to a new spreadsheet parameter. To do this, expand the drop-down list for the Value column and select the New Spreadsheet Parameter... item.

  • In the invoked Spreadsheet Parameter dialog, you can specify the required parameter settings (its name, type and initial value).

At runtime, the Parameters panel displays query parameters and allows end-user's to modify them. The following picture illustrates how to specify the order ID using the Parameters panel.

The resulting report displayed for the order ID equal to 10300 is shown below.

Is this topic helpful?​​​​​​​