XtraReport.ParametersRequestValueChanged Event

Occurs when the parameter values are changed in the Parameters UI.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v21.2.dll

Declaration

public event EventHandler<ParametersRequestValueChangedEventArgs> ParametersRequestValueChanged

Event Data

The ParametersRequestValueChanged event's data class is ParametersRequestValueChangedEventArgs. The following properties provide information specific to this event:

Property Description
ChangedParameterInfo Contains information about the parameter, which value was changed.
ErrorText
ParametersInformation

Remarks

The ParametersRequestValueChanged event fires only for Windows Forms applications.

Note

The ParametersRequestValueChanged event is not raised for subreports. You can handle this event for a main report and use the ParametersRequestValueChangedEventArgs class to access the subreports’ parameters in the event handler.

Example

This example demonstrates how to perform report parameter validation, and restore the previous parameter value if the validation fails (if the parameter value is greater than 10 or less than 0).

This is achieved by handling the report’s XtraReport.ParametersRequestSubmit and XtraReport.ParametersRequestValueChanged events.

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using DevExpress.XtraReports.UI;
using DevExpress.XtraReports.Parameters;
// ...

namespace CancelSubmitParameters {
    public partial class XtraReport1 : XtraReport {
        int parameter;
        public XtraReport1() {
            InitializeComponent();
        }

        private void XtraReport1_ParametersRequestSubmit(object sender, 
            ParametersRequestEventArgs e) {
            if ((int)e.ParametersInformation[0].Parameter.Value > 10 || 
                (int)e.ParametersInformation[0].Parameter.Value < 0) {
                e.ParametersInformation[0].Parameter.Value = parameter;
                e.ParametersInformation[0].Editor.Text = parameter.ToString();
            }
        }

        private void XtraReport1_ParametersRequestValueChanged(object sender, 
            ParametersRequestValueChangedEventArgs e) {
            parameter = (int)e.ChangedParameterInfo.Parameter.Value;
        }

    }
}
See Also