ReportExecutionService.SetExecutionParameters2 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::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.ExecutionInfo2Public Function SetExecutionParameters2 (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo2Parameters
- 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.