ReportExecutionService.SetExecutionParameters Method

Definition

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

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

Parameters

Parameters
ParameterValue[]

An array of ParameterValue objects.

ParameterLanguage
String

A .NET Framework locale identifier.

Returns

An ExecutionInfo 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 are set, it will be cleared if it is not an execution or a history snapshot, which will require the report to be executed again. For execution or history snapshots, you can specify values for non-query parameters. Note the report server does not perform data processing for execution or history snapshots.

If the parameter value you specify has an incorrect type, the method will return an error and the parameter is not changed. If the parameter value has the correct type, but is not a valid value, the parameter enters the MissingValidValue state. In both cases, attempting to render the report will cause an error.

If ParameterLanguage is not specified, the language specified in the Accepts-Language HTTP header. If no language is specified for the Accepts-Language HTTP header, the default language on the report server is used.

Applies to