ReportExecutionService.SetExecutionParameters Method (ParameterValue , String)

  • Article

 

Applies To: SQL Server 2016 Preview

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

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

Syntax

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 As ParameterValue(),
    ParameterLanguage As String
) As 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.

See Also

ReportExecutionService Class
ReportExecution2005 Namespace

Return to top