Report Parameters Dialog Box (Visual Studio Report Designer)

Use the Report Parameters dialog box to define parameters for a report that is processed in local mode. You can define parameters to support conditional formatting or to use in expressions or code. You cannot use the Report Parameters dialog box to map report parameters to query parameters or use them in data source filters. In local processing mode, all data processing is handled independently of report processing. If you want to pass report parameters to a query or data source filter, you must do so in application code. To view an example of how this can be done, see Sample: Using an RSS Feed in ReportViewer.

The parameters properties that you specify in the Report Parameters dialog box become part of the report definition. Some properties are intended for programmatic use only. In contrast with reports that are processed on a remote report server, a locally processed report does not have a parameter input area used for selecting or typing parameter values. For more information about how parameter properties are used programmatically, see ReportParameterInfo and ReportParameterInfo.

Options

  • Parameters
    Use this list to view and modify report parameter properties in the current report definition. To move a parameter within the list, click the parameter, and then click the up or down arrow.
  • Add
    Choose this option to create a new report parameter.
  • Remove
    Click a parameter, and then choose this option to delete the parameter.
  • Name
    Type a name for the parameter. Do not use special characters in the name. The name must be Common Language Specification (CLS) compliant.
  • Prompt
    Type a text string to set a parameter prompt value. This setting has no effect in a client report definition.
  • Data type
    Select the data type of the parameter.
  • Hidden
    Specify this option to set the PromptUser property. This setting has no effect in a client report definition.
  • Internal
    Specify this option to set the Visible property.
  • Multivalue
    Specify this option to set the Multivalue property.
  • Allow null value
    Specify this option if the value for the parameter can be null.
  • Allow blank value
    Specify this option if the value of the parameter can be an empty string.
  • Available values
    Specify a static list of report parameter values. You can type a value, or write an expression that provides the value to use. Available values are specified as a name-value pair.
  • Default values
    Specify a default value to use. If you are configuring a multivalued parameter, you can specify multiple defaults. Otherwise, only the first value is used.
  • Null
    Select Null if you do not want to provide a default value for the parameter.

See Also

Concepts

Defining Report Parameters in a Report (Visual Studio Report Designer)
ReportViewer Controls (Visual Studio)
ReportViewer Web Server and Windows Forms Controls

Other Resources

Report Designer User Interface Reference (Visual Studio)