ReportExecutionService.SetExecutionParameters Method
Sets and validates parameter values associated with the current report execution.
Namespace: ReportExecution2005
Assembly: ReportExecution2005 (in ReportExecution2005.dll)
Syntax
'Declaration
Public Function SetExecutionParameters ( _
Parameters As ParameterValue(), _
ParameterLanguage As String _
) As ExecutionInfo
'Usage
Dim instance As ReportExecutionService
Dim Parameters As ParameterValue()
Dim ParameterLanguage As String
Dim returnValue As ExecutionInfo
returnValue = instance.SetExecutionParameters(Parameters, _
ParameterLanguage)
public ExecutionInfo SetExecutionParameters(
ParameterValue[] Parameters,
string ParameterLanguage
)
public:
ExecutionInfo^ SetExecutionParameters(
array<ParameterValue^>^ Parameters,
String^ ParameterLanguage
)
member SetExecutionParameters :
Parameters:ParameterValue[] *
ParameterLanguage:string -> ExecutionInfo
public function SetExecutionParameters(
Parameters : ParameterValue[],
ParameterLanguage : String
) : ExecutionInfo
Parameters
- Parameters
Type: array<ReportExecution2005.ParameterValue[]
An array of ParameterValue objects.
- ParameterLanguage
Type: System.String
A .NET Framework locale identifier.
Return Value
Type: ReportExecution2005.ExecutionInfo
An ExecutionInfo object containing the new execution.
Remarks
The table below shows header and permissions information on this operation.
SOAP Header Usage |
(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: 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.