ReportExecutionService.SetExecutionParameters Method

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

Namespace:  ReportExecution2005
Assembly:  ReportExecution2005 (in ReportExecution2005.dll)

Syntax

'Declaration
<SoapHeaderAttribute("ExecutionHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionParameters", RequestNamespace := "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    ResponseNamespace := "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
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)
[SoapHeaderAttribute("ExecutionHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionParameters", RequestNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public ExecutionInfo SetExecutionParameters(
    ParameterValue[] Parameters,
    string ParameterLanguage
)
[SoapHeaderAttribute(L"ExecutionHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionParameters", RequestNamespace = L"http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = L"http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
ExecutionInfo^ SetExecutionParameters(
    array<ParameterValue^>^ Parameters, 
    String^ ParameterLanguage
)
[<SoapHeaderAttribute("ExecutionHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionParameters", RequestNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member SetExecutionParameters : 
        Parameters:ParameterValue[] * 
        ParameterLanguage:string -> ExecutionInfo 
public function SetExecutionParameters(
    Parameters : ParameterValue[], 
    ParameterLanguage : String
) : ExecutionInfo

Parameters

  • 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) 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: 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.