Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Collapse]Spreadsheet
   [Expand]Product Information
    Product Structure
    Getting Started
   [Expand]Spreadsheet Document
    Supported Formats
   [Expand]Cell Basics
   [Expand]Spreadsheet Formulas
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
    Data Grouping
   [Expand]Pivot Table Overview
   [Expand]Charting Overview
    Printing
    Events
   [Collapse]Mail Merge Overview
     Mail Merge Ribbon Tab
     Mail Merge Design View
     Field List Panel
     Parameters Panel
     Data Source Wizard
     Mail Merge Functions
     Template Document
    Protection
    Find and Replace
   [Expand]Visual Elements
    Services
   [Expand]Shortcuts
   [Expand]Examples
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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.

How would you rate this topic?​​​​​​​