Share via


ReportExecutionService.SetExecutionParameters2 Method

Definition

Sets and validates parameter values associated with the current report execution.

public:
 ReportExecution2005::ExecutionInfo2 ^ SetExecutionParameters2(cli::array <ReportExecution2005::ParameterValue ^> ^ Parameters, System::String ^ ParameterLanguage);
public ReportExecution2005.ExecutionInfo2 SetExecutionParameters2 (ReportExecution2005.ParameterValue[] Parameters, string ParameterLanguage);
member this.SetExecutionParameters2 : ReportExecution2005.ParameterValue[] * string -> ReportExecution2005.ExecutionInfo2
Public Function SetExecutionParameters2 (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo2

Parameters

Parameters
ParameterValue[]

An array of ParameterValue objects.

ParameterLanguage
String

A .NET Framework locale identifier.

Returns

An ExecutionInfo2 object containing the new execution.

Remarks

The table below shows header and permissions information on this operation.

SOAP Header Usage (In) TrustedUserHeaderValue

(In) ExecutionHeaderValue

(Out) ServerInfoHeaderValue
Native Mode Required Permissions On the main report and all subreports: ReadProperties AND ExecuteAndView
SharePoint Mode Required Permissions On the main report and all subreports: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

If a snapshot exists in the current execution when the parameter values used in the query are set, it will be cleared (if it is not an execution or a history snapshot). Setting non-query parameters will not cause the snapshot to be cleared, but will require processing before it can be rendered.

If parameters do not pass the validation, then the method will return an error and the parameter values will not be changed.

If ParameterLanguage is specified, parameters are interpreted in this language. If ParameterLanguage is not specified, the default behavior is used.

You cannot specify parameters for execution or history snapshots.

Applies to