corelibraries-devexpress-dot-xtrareports-dot-parameters-dot-parameter-75cd2eae.md
Gets or sets settings used to generate predefined values for a report parameter.
Namespace : DevExpress.XtraReports.Parameters
Assembly : DevExpress.Printing.v25.2.Core.dll
NuGet Package : DevExpress.Printing.Core
[DefaultValue(null)]
public virtual ValueSourceSettings ValueSourceSettings { get; set; }
<DefaultValue(Nothing)>
Public Overridable Property ValueSourceSettings As ValueSourceSettings
| Type | Default | Description |
|---|---|---|
| ValueSourceSettings | null |
Settings used to generate predefined values for a report parameter.
|
Set the ValueSourceSettings property to one of the following class instances:
The code sample below demonstrates how to do the following:
using DevExpress.XtraReports.Parameters;
// ...
// Create a parameter and set up its properties. Set the
// parameter's MultiValue property to true to make it multi-value.
var parameter1 = new Parameter() {
Name = "categories",
Description = "Categories: ",
Type = typeof(System.Int32),
MultiValue = true
};
// Create a DynamicListLookUpSettings class instance and
// configure its properties to retrieve the parameter's predefined values
// from the report's data source.
var lookupSettings = new DynamicListLookUpSettings() {
DataSource = report.DataSource,
DataMember = "Categories",
DisplayMember = "CategoryName",
ValueMember = "CategoryId"
};
// Assign the setting to the parameter's LookUpSettings property.
parameter1.LookUpSettings = lookupSettings;
// Enable the parameter's SelectAllValues property to use
// all predefined values as defaults.
parameter1.SelectAllValues = true;
Imports DevExpress.XtraReports.Parameters
' ...
' Create a parameter and set up its properties. Set the
' parameter's MultiValue property to true to make it multi-value.
Dim parameter1 = New Parameter() With {
.Name = "categories",
.Description = "Categories: ",
.Type = GetType(System.Int32),
.MultiValue = True
}
' Create a DynamicListLookUpSettings class instance and
' configure its properties to retrieve the parameter's predefined values
' from the report's data source.
Dim lookupSettings = New DynamicListLookUpSettings() With {
.DataSource = report.DataSource,
.DataMember = "Categories",
.DisplayMember = "CategoryName",
.ValueMember = "CategoryId"
}
' Assign the setting to the parameter's LookUpSettings property.
parameter1.LookUpSettings = lookupSettings
' Enable the parameter's SelectAllValues property to use
' all predefined values as defaults.
parameter1.SelectAllValues = True
The following code snippets (auto-collected from DevExpress Examples) contain references to the ValueSourceSettings property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
reporting-winforms-parameter-daterange/CS/Program.cs#L41
// Assign the settings to the parameter's ValueSourceSettings property.
dateRangeParam.ValueSourceSettings = dateRangeSettings;
reporting-winforms-parameter-dynamic-list/CS/Form1.cs#L40
// Assign data storage settings to the parameter's ValueSourceSettings property.
param.ValueSourceSettings = lookupSettings;
reporting-winforms-parameter-daterange/VB/Program.vb#L33
' Assign the settings to the parameter's ValueSourceSettings property.
dateRangeParam.ValueSourceSettings = dateRangeSettings
reporting-winforms-parameter-static-list/VB/Form1.vb#L59
' Assign the specified settings to the parameter's ValueSourceSettings property.
dateParameter.ValueSourceSettings = lookupSettings
reporting-winforms-parameter-dynamic-list/VB/Form1.vb#L39
' Assign data storage settings to the parameter's ValueSourceSettings property.
param.ValueSourceSettings = lookupSettings
See Also