ReportingService2010.TestConnectForItemDataSource 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
測試資料來源的連線。 此方法支援對報告或模型及共享資料來源所使用的已發表資料來源進行測試。 此方法適用於 Report、 和 ModelDataset 項目類型。
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的完全限定網址，包括檔名，以及在 SharePoint 模式下的副檔名。 項目可以是共享資料來源、報告或報告模型。
- DataSourceName
- String
該項目的資料來源名稱。
- UserName
- String
用來測試連線的使用者名稱。
UserName 與會提示憑證的資料來源一起使用。
- Password
- String
用來測試連線的密碼。
Password 與會提示憑證的資料來源一起使用。
- ConnectError
- String
詳細的錯誤訊息。 當連線失敗時，訊息會被回傳。 資料來源提供者會提供詳細訊息。
傳回
一個包含詳細錯誤訊息的字串。 字串會以輸出參數 ConnectError回傳。
一個布林值表示連線是否成功完成。
- 屬性
備註
下表顯示此操作的標頭與權限資訊。
| SOAP 標頭的使用 | （在） TrustedUserHeaderValue （出局） ServerInfoHeaderValue |
| 原生模式所需權限 | 這取決於物品類型： - Report， ： DataSetReadDatasource- 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。