Freigeben über


ReportingService2010.TestConnectForItemDataSource Methode

Definition

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

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

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: