ReportingService2010.TestConnectForItemDataSource Methode

Referenz

Definition

Namespace:: ReportService2010

Assembly:: ReportService2010.dll

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 Tests von veröffentlichten Datenquellen, die von Berichten oder Modellen und freigegebenen Datenquellen verwendet werden. Diese Methode gilt für die Elementtypen Report, Model und Dataset.

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 vollqualifizierte URL des Elements, auf das angewendet wird DataSourceName , einschließlich des Dateinamens und im SharePoint-Modus der Erweiterung. Dabei kann es sich um eine freigegebene Datenquelle, einen Bericht oder ein Berichtsmodell handeln.

DataSourceName: String

Der Name der Datenquelle für das Element.

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

Boolean

Eine Zeichenfolge, die eine detaillierte Fehlermeldung enthält. Die Zeichenfolge wird als Ausgabeparameter (ConnectError) zurückgegeben.

Ein boolescher Wert, der angibt, ob die Verbindung erfolgreich hergestellt wurde.

Attribute: SoapDocumentMethodAttribute SoapHeaderAttribute

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.


SOAP-Headerverwendung	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen für den einheitlichen Modus	Hängt vom Elementtyp ab: - `Report`, `DataSet`: ReadDatasource - `Report` Verwenden eines Modells: ReadDatasource im Bericht UND ReadDatasource im Modell - `Report` Verwenden einer freigegebenen Datenquelle: ReadDatasource im Bericht UND ReadContent in der freigegebenen Datenquelle - `DataSource`: ReadContent - `Model`: ReadDatasource
Erforderliche Berechtigungen im SharePoint-Modus	Hängt vom Elementtyp ab: - `Report`, `DataSet`: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> on `ItemPath` - `Report` Verwenden eines Modells oder einer freigegebenen Datenquelle: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> on `DataSourceName` - `DataSource`: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> - `Model`: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems>

Wenn DataSourceName auf eine XML-Datenquelle verweist, führt diese Methode nichts aus und gibt zurück true.

Gilt für: