ReportingService2010.TestConnectForItemDataSource 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
测试数据源的连接。 此方法支持已发布的数据源的测试，这些数据源由报表或模型和共享数据源使用。 此方法适用于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 -> boolPublic 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
一条详细的错误消息。 连接失败时会返回此消息。 数据源提供程序提供详细消息。
返回
一个包含详细错误消息的字符串。 该字符串作为输出参数 ConnectError 返回。
一个指示连接是否成功建立的布尔值。
- 属性
注解
下表显示了有关此操作的标头和权限信息。
| 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。