ReportViewer.SubmittingParameterValues Event

Occurs when report parameter values are submitted to the report server.

Namespace: Microsoft.Reporting.WebForms
Assembly: Microsoft.ReportViewer.WebForms (in microsoft.reportviewer.webforms.dll)

Syntax

'Declaration
Public Event SubmittingParameterValues As ReportParametersEventHandler
'Usage
Dim instance As ReportViewer
Dim handler As ReportParametersEventHandler

AddHandler instance.SubmittingParameterValues, handler

public event ReportParametersEventHandler SubmittingParameterValues

public:
event ReportParametersEventHandler^ SubmittingParameterValues {
    void add (ReportParametersEventHandler^ value);
    void remove (ReportParametersEventHandler^ value);
}

/** @event */
public void add_SubmittingParameterValues (ReportParametersEventHandler value)

/** @event */
public void remove_SubmittingParameterValues (ReportParametersEventHandler value)

JScript supports the use of events, but not the declaration of new ones.

Remarks

This event occurs when the user clicks the View Report button or when report parameters are automatically submitted due to dependencies between them. Information about this event is passed in a ReportParametersEventArgs object to the ReportParametersEventHandler delegate, which handles the event. This event only applies to remote processing mode.

Handle this event to read or modify the report parameters before they are submitted to the report server. For more information about handling events, see Consuming Events.

Example

If you want to prevent parameters from being automatically submitted, subscribe to this event and use the following code. Note that this code does not prevent the ReportViewer control from initiating a postback.

Private Sub reportViewer1_SubmittingParameterValues(ByVal sender As Object, ByVal e As ReportParametersEventArgs)
    If e.AutoSubmit Then
        e.Cancel = True
    End If
End Sub

void reportViewer1_SubmittingParameterValues(object sender, ReportParametersEventArgs e)
{
    if (e.AutoSubmit)
        e.Cancel = true;
}

See Also

Reference

ReportViewer Class
ReportViewer Members
Microsoft.Reporting.WebForms Namespace
ReportParameter Class
ReportParameterCollection Class