ReportingService2010.TestConnectForDataSourceDefinition 方法

定义

命名空间:

ReportService2010

程序集:

ReportService2010.dll

测试数据源的连接。 此方法支持数据源的直接测试。

public:
 bool TestConnectForDataSourceDefinition(ReportService2010::DataSourceDefinition ^ DataSourceDefinition, System::String ^ UserName, System::String ^ Password, [Runtime::InteropServices::Out] System::String ^ % ConnectError);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public bool TestConnectForDataSourceDefinition (ReportService2010.DataSourceDefinition DataSourceDefinition, string UserName, string Password, out string ConnectError);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.TestConnectForDataSourceDefinition : ReportService2010.DataSourceDefinition * string * string * string -> bool

Public Function TestConnectForDataSourceDefinition (DataSourceDefinition As DataSourceDefinition, UserName As String, Password As String, ByRef ConnectError As String) As Boolean

参数

DataSourceDefinition

DataSourceDefinition

定义到数据源的连接的数据源定义。

UserName

String

要用于测试连接的用户名。UserName 与提示需要凭据的数据源一起使用。

Password

String

要用于测试连接的密码。Password 与提示需要凭据的数据源一起使用。

ConnectError

String

一条详细的错误消息。 连接失败时会返回此消息。 数据源提供程序提供详细消息。

返回

Boolean

一个指示连接是否成功建立的布尔值。

一个包含详细错误消息的字符串。 该字符串作为输出参数 ConnectError 返回。

属性

SoapDocumentMethodAttribute SoapHeaderAttribute

注解

下表显示了有关此操作的标头和权限信息。

SOAP 标头用法	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
本机模式所需权限	ExecuteReportDefinition (系统)
SharePoint 模式所需权限	需要将系统属性 EnableLoadReportDefinition 设置为 true

需要执行报表定义的权限。