ReportExecutionService.SetExecutionParameters2 Method (ParameterValue , String)

 

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 ExecutionInfo2 SetExecutionParameters2(
    ParameterValue[] Parameters,
    string ParameterLanguage
)
public:
ExecutionInfo2^ SetExecutionParameters2(
    array<ParameterValue^>^ Parameters,
    String^ ParameterLanguage
)
member SetExecutionParameters2 : 
        Parameters:ParameterValue[] *
        ParameterLanguage:string -> ExecutionInfo2
Public Function SetExecutionParameters2 (
    Parameters As ParameterValue(),
    ParameterLanguage As String
) As ExecutionInfo2

Parameters

  • ParameterLanguage
    Type: System.String

    A .NET Framework locale identifier.

Return Value

Type: ReportExecution2005.ExecutionInfo2

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

See Also

ReportExecutionService Class
ReportExecution2005 Namespace

Return to top