Dela via


ReportExecutionService.SetExecutionCredentials Method

Sets the credentials associated with the current report execution.

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

Syntax

'Declaration
<SoapHeaderAttribute("ExecutionHeaderValue")> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionCredentials", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Function SetExecutionCredentials ( _
    Credentials As DataSourceCredentials() _
) As ExecutionInfo
'Usage
Dim instance As ReportExecutionService
Dim Credentials As DataSourceCredentials()
Dim returnValue As ExecutionInfo

returnValue = instance.SetExecutionCredentials(Credentials)
[SoapHeaderAttribute("ExecutionHeaderValue")]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionCredentials", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public ExecutionInfo SetExecutionCredentials(
    DataSourceCredentials[] Credentials
)
[SoapHeaderAttribute(L"ExecutionHeaderValue")]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionCredentials", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
ExecutionInfo^ SetExecutionCredentials(
    array<DataSourceCredentials^>^ Credentials
)
[<SoapHeaderAttribute("ExecutionHeaderValue")>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetExecutionCredentials", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member SetExecutionCredentials : 
        Credentials:DataSourceCredentials[] -> ExecutionInfo 
public function SetExecutionCredentials(
    Credentials : DataSourceCredentials[]
) : ExecutionInfo

Parameters

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 when the credentials are set and AllowQueryExecution is false, the snapshot will be cleared, and any parameters will be reset to their default values.

If there are multiple data sources that prompt for the same report, you need to specify all of the credentials at the same time. If one set of credentials must be changed, you must supply all of the credentials again.

Credentials are only persisted for the lifetime of the execution, after which they must be specified again.