ParametersRequestValueChangedEventArgs.ChangedParameterInfo Property

Contains information about the parameter, which value was changed.

Namespace: DevExpress.XtraReports.Parameters

Assembly: DevExpress.Printing.v18.2.Core.dll

Declaration

C#

public ParameterInfo ChangedParameterInfo { get; }

VB.NET

Public ReadOnly Property ChangedParameterInfo As ParameterInfo

Property Value

Type	Description
ParameterInfo	A ParameterInfo object.

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.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-cancel-parameter-submitting-if-user-input-validation-fails-e2045

XtraReport1.cs

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;
        }

    }
}

Form1.cs

using System;
using System.Windows.Forms;
using DevExpress.XtraReports.UI;
// ...

namespace CancelSubmitParameters {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e) {
            XtraReport1 report = new XtraReport1();
            ReportPrintTool printTool = new ReportPrintTool(report);
            printTool.ShowPreviewDialog();
        }

    }
}

XtraReport1.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Drawing
Imports System.Collections
Imports System.ComponentModel
Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraReports.Parameters
' ...

Namespace CancelSubmitParameters
    Partial Public Class XtraReport1
        Inherits XtraReport
        Private parameter As Integer
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub XtraReport1_ParametersRequestSubmit(ByVal sender As Object, _
            ByVal e As ParametersRequestEventArgs) Handles MyBase.ParametersRequestSubmit
            If CInt(Fix(e.ParametersInformation(0).Parameter.Value)) > 10 _
                OrElse CInt(Fix(e.ParametersInformation(0).Parameter.Value)) < 0 Then
                e.ParametersInformation(0).Parameter.Value = parameter
                e.ParametersInformation(0).Editor.Text = parameter.ToString()
            End If
        End Sub

        Private Sub XtraReport1_ParametersRequestValueChanged(ByVal sender As Object, _
            ByVal e As ParametersRequestValueChangedEventArgs) Handles MyBase.ParametersRequestValueChanged
            parameter = CInt(Fix(e.ChangedParameterInfo.Parameter.Value))
        End Sub

    End Class
End Namespace

Form1.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraReports.UI
' ...

Namespace CancelSubmitParameters
    Partial Public Class Form1
        Inherits Form
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) Handles button1.Click
            Dim report As New XtraReport1()
            Dim printTool As New ReportPrintTool(report)
            printTool.ShowPreviewDialog()
        End Sub

    End Class
End Namespace