ReportExecutionService.SetExecutionParameters Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.ExecutionInfoPublic Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfoParameters
- 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.