TestConnectForDataSourceDefinition 方法
測試資料來源的連接。這個方法支援資料來源的直接測試。
命名空間: ReportService2010
組件: ReportService2010 (在 ReportService2010.dll 中)
語法
'宣告
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Function TestConnectForDataSourceDefinition ( _
DataSourceDefinition As DataSourceDefinition, _
UserName As String, _
Password As String, _
<OutAttribute> ByRef ConnectError As String _
) As Boolean
'用途
Dim instance As ReportingService2010
Dim DataSourceDefinition As DataSourceDefinition
Dim UserName As String
Dim Password As String
Dim ConnectError As String
Dim returnValue As Boolean
returnValue = instance.TestConnectForDataSourceDefinition(DataSourceDefinition, _
UserName, Password, ConnectError)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public bool TestConnectForDataSourceDefinition(
DataSourceDefinition DataSourceDefinition,
string UserName,
string Password,
out string ConnectError
)
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
bool TestConnectForDataSourceDefinition(
DataSourceDefinition^ DataSourceDefinition,
String^ UserName,
String^ Password,
[OutAttribute] String^% ConnectError
)
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/TestConnectForDataSourceDefinition", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member TestConnectForDataSourceDefinition :
DataSourceDefinition:DataSourceDefinition *
UserName:string *
Password:string *
ConnectError:string byref -> bool
public function TestConnectForDataSourceDefinition(
DataSourceDefinition : DataSourceDefinition,
UserName : String,
Password : String,
ConnectError : String
) : boolean
參數
- DataSourceDefinition
型別:ReportService2010. . :: . .DataSourceDefinition
定義資料來源連接的資料來源定義。
- UserName
型別:System. . :: . .String
用來測試連接的使用者名稱。UserName 是搭配提示輸入認證的資料來源使用。
- Password
型別:System. . :: . .String
用來測試連接的密碼。Password 是搭配提示輸入認證的資料來源使用。
- ConnectError
型別:System. . :: . .String%
詳細的錯誤訊息。連接失敗時會傳回此訊息。來源資料提供者會提供詳細的訊息。
傳回值
型別:System. . :: . .Boolean
指出連接是否已順利完成的 Boolean。
包含詳細錯誤訊息的字串。此字串是以 out 參數 ConnectError 傳回。
備註
The table below shows header and permissions information on this operation.
SOAP Header Usage |
(Out) ServerInfoHeaderValue |
Native Mode Required Permissions |
ExecuteReportDefinition (System) |
SharePoint Mode Required Permissions |
Needs the system property EnableLoadReportDefinition set to true |
Permission to execute the report definition is required.