ReportingService2010.TestConnectForDataSourceDefinition Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Testet die Verbindung für eine Datenquelle. Diese Methode unterstützt direkte Datenquellentests.
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
Parameter
- DataSourceDefinition
- DataSourceDefinition
Die Datenquellendefinition, mit der die Verbindung mit der Datenquelle definiert wird.
- UserName
- String
Der Benutzername, der zum Testen der Verbindung verwendet werden soll.UserName
wird bei Datenquellen verwendet, die Anmeldeinformationen verlangen.
- Password
- String
Das Kennwort, das zum Testen der Verbindung verwendet werden soll.Password
wird bei Datenquellen verwendet, die Anmeldeinformationen verlangen.
- ConnectError
- String
Eine detaillierte Fehlermeldung. Die Meldung wird zurückgegeben, wenn die Verbindung nicht hergestellt werden kann. Der Datenquellenanbieter gibt die detaillierte Meldung zurück.
Gibt zurück
Ein boolescher Wert, der angibt, ob die Verbindung erfolgreich hergestellt wurde.
Eine Zeichenfolge, die eine detaillierte Fehlermeldung enthält. Die Zeichenfolge wird als Ausgabeparameter (ConnectError
) zurückgegeben.
- Attribute
Hinweise
In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.
SOAP-Headerverwendung | (In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue |
Erforderliche Berechtigungen im einheitlichen Modus | ExecuteReportDefinition (System) |
Erforderliche Berechtigungen im SharePoint-Modus | Erfordert, dass die Systemeigenschaft EnableLoadReportDefinition auf festgelegt ist true |
Die Berechtigung zum Ausführen der Berichtsdefinition ist erforderlich.