Sprache

ReportingService2010.TestConnectForItemDataSource Methode

Definition

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

Gilt für: