ReportingService2010.TestConnectForItemDataSource 方法

定义

命名空间:

ReportService2010

程序集:

ReportService2010.dll

测试数据源的连接。 此方法支持已发布的数据源的测试，这些数据源由报表或模型和共享数据源使用。 此方法适用于Report、Model和Dataset项类型。

public:
 bool TestConnectForItemDataSource(System::String ^ ItemPath, System::String ^ DataSourceName, 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/TestConnectForItemDataSource", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public bool TestConnectForItemDataSource (string ItemPath, string DataSourceName, string UserName, string Password, out string ConnectError);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForItemDataSource", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.TestConnectForItemDataSource : string * string * string * string * string -> bool

Public Function TestConnectForItemDataSource (ItemPath As String, DataSourceName As String, UserName As String, Password As String, ByRef ConnectError As String) As Boolean

参数

ItemPath

String

应用的项 DataSourceName 的完全限定 URL，包括文件名，以及 SharePoint 模式下的扩展名。 该项可以是共享数据源、报表或报表模型。

DataSourceName

String

项的数据源的名称。

UserName

String

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

Password

String

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

ConnectError

String

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

返回

Boolean

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

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

属性

SoapDocumentMethodAttribute SoapHeaderAttribute

注解

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

SOAP 标头用法	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
本机模式所需的权限	取决于项类型： - Report, DataSet: ReadDatasource - Report 使用模型： ReadDatasource 在报表上和 ReadDatasource 模型上使用 - Report 使用共享数据源： ReadDatasource 在报表 ReadContent 和共享数据源上 - DataSource: ReadContent - Model: ReadDatasource
SharePoint 模式所需权限	取决于项类型： - Report、 DataSet： <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> on ItemPath - Report使用模型或共享数据源： <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems>DataSourceName - DataSource: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> - Model: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems>

如果 DataSourceName 指向 XML 数据源，此方法不执行任何操作，并返回 true。