ReportingService2010.TestConnectForItemDataSource 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 auf eine Datenquelle. Diese Methode unterstützt das Testen veröffentlichter Datenquellen, die von Berichten oder Modellen und gemeinsamen Datenquellen verwendet werden. Diese Methode gilt für die , Model, und Dataset Item-TypenReport.
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
Parameter
- ItemPath
- String
Die vollständig qualifizierte URL des Elements, auf das es angewendet wirdDataSourceName, einschließlich des Dateinamens und, im SharePoint-Modus, der Endung. Das Element kann eine gemeinsame Datenquelle, ein Bericht oder ein Berichtsmodell sein.
- DataSourceName
- String
Der Name der Datenquelle für den Artikel.
- UserName
- String
Der Benutzername, den man zum Testen der Verbindung verwenden sollte.
UserName wird mit Datenquellen verwendet, die nach Zugangsdaten fragen.
- Password
- String
Das Passwort, das man zum Testen der Verbindung verwenden soll.
Password wird mit Datenquellen verwendet, die nach Zugangsdaten fragen.
- ConnectError
- String
Eine detaillierte Fehlermeldung. Die Nachricht wird zurückgegeben, wenn die Verbindung fehlschlägt. Der Datenquellenanbieter liefert die detaillierte Nachricht.
Gibt zurück
Eine Zeichenkette, die eine detaillierte Fehlermeldung enthält. Die Zeichenkette wird als Aus-Parameter zurückgegeben. ConnectError
Ein Boolean zeigt an, ob die Verbindung erfolgreich abgeschlossen wurde.
- Attribute
Hinweise
Die untenstehende Tabelle zeigt Header- und Berechtigungsinformationen zu dieser Operation.
| Verwendung von SOAP-Headern | (In) TrustedUserHeaderValue (Aus) ServerInfoHeaderValue |
| Erforderliche Berechtigungen im nativen Modus | Hängt vom Gegenstandstyp ab: - Report, DataSet: ReadDatasource- Report Verwendung eines Modells: ReadDatasource auf dem Bericht UND ReadDatasource auf dem Modell- Report Verwendung einer gemeinsamen Datenquelle: ReadDatasource auf dem Bericht UND ReadContent auf der gemeinsamen Datenquelle- DataSource: ReadContent- Model: ReadDatasource |
| Erforderliche Berechtigungen im SharePoint-Modus | Hängt vom Gegenstandstyp ab: - Report, DataSet: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> auf ItemPath- Report Verwendung eines Modells oder einer gemeinsamen Datenquelle: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> auf DataSourceName- DataSource: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems>- Model: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> |
Wenn DataSourceName auf eine XML-Datenquelle verweist, bewirkt diese Methode nichts und gibt . zurück.true