WebServiceConnection Klasse

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.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.

Stellt eine Verbindung mit einem XML-Webdienst dar.

public ref class WebServiceConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class WebServiceConnection : Microsoft.Office.InfoPath.DataConnection

type WebServiceConnection = class
    inherit DataConnection

Public MustInherit Class WebServiceConnection
Inherits DataConnection

Vererbung: Object

DataConnection
WebServiceConnection

Beispiele

Im folgenden Beispiel wird ein Verweis auf das WebServiceConnection-Objekt festgelegt, das die Verbindung mit dem Namen "Main query" darstellt, indem der Name an die Item[String] Eigenschaft der DataConnectionCollection-Klasse übergeben und dann das zurückgegebene Objekt in den WebServiceConnection-Typ umgewandelt wird.

WebServiceConnection wsConnection = (WebServiceConnection)this.DataConnections["Main query"];

Dim wsConnection As WebServiceConnection = _
   DirectCast(Me.DataConnections("Main query"), WebServiceConnection)

Nachdem der Verweis festgelegt wurde, können Sie die Eigenschaften des WebServiceConnection-Objekts verwenden, wie im folgenden Beispiel gezeigt, das eine Zeichenfolgenvariable auf den von der ServiceUrl -Eigenschaft zurückgegebenen Wert festlegt.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

Dim wsServiceURL As String = _
   string wsServiceURL = wsConnection.ServiceUrl.ToString()

Hinweise

Die WebServiceConnection-Klasse stellt eine Datenverbindung dar, die in InfoPath mithilfe des Datenverbindungs-Assistenten erstellt wurde und alle Informationen angibt, die zum Abrufen von Daten aus einer externen Datenquelle und zum Übermitteln von Daten an eine externe Datenquelle mithilfe eines Webdiensts erforderlich sind.

WebServiceConnection stellt Eigenschaften bereit, die zum Abrufen und Festlegen von Informationen zu den Eingabe- und Vorgangszeichenfolgen der Datenverbindung verwendet werden können. Außerdem wird eine Eigenschaft bereitgestellt, um den URL (Uniform Resource Locator) der WSDL-Datei (Web Services Description Language) des XML-Webdienstes abzurufen.

Auf das webServiceConnection-Objekt , das der Datenverbindung zugeordnet ist, kann mithilfe der DataConnections -Eigenschaft der XmlForm -Klasse zugegriffen werden, um die Verbindung von der DataConnectionCollection der Formularvorlage zurückzugeben.

Zusätzlich zur Standardmethode Execute() , die von der DataConnection Basisklasse geerbt wird, die einen Abfrage- oder Übermittlungsvorgang mit den Werten ausführt, die im InfoPath-Formularvorlagenentwurfsmodus deklarativ definiert wurden, stellt die WebServiceConnection-Klasse auch die -Methode bereit, mit der Execute(XPathNavigator, XPathNavigator, XPathNavigator) Sie eine andere Datenquelle angeben können, die übermittelt werden soll, und einen anderen Speicherort zum Einfügen der zurückgegebenen Daten. und eine Möglichkeit zum Abrufen von Fehlern, die von der Verbindung zurückgegeben werden.

Die WebServiceConnection-Klasse entspricht der WebServiceAdapterObject-Schnittstelle des Microsoft Office InfoPath 2003-Objektmodells.

Konstruktoren

WebServiceConnection()

Stellt eine Verbindung mit einem XML-Webdienst dar.

Eigenschaften

Name	Ruft den Namen der Datenverbindung ab. (Geerbt von DataConnection)
ServiceUrl	Ruft die URL (Uniform Resource Locator) ab, die zum Aufrufen des einem WebServiceConnection -Objekt zugeordneten Webdiensts verwendet wird, oder legt diesen fest.
SoapAction	Ruft den Wert des soapAction-Attributs des Webdiensts ab, der einem -Objekt zugeordnet ist, oder legt den Wert fest WebServiceConnection .
Timeout	Ruft den Timeoutwert in Sekunden für die WebServiceConnection einem -Objekt zugeordnete Datenverbindung ab oder legt den Timeoutwert fest.
WsdlUrl	Ruft die URL (Uniform Resource Locator) der WSDL-Datei (Web Services Description Language) für den Webdienst ab, der dem WebServiceConnection -Objekt zugeordnet ist.

Methoden

Execute()	Je nachdem, von welcher ConnectionType die Connection-Klasse aufgerufen wird, wird ein Sende- oder Abfragevorgang in der Datenverbindung ausgeführt. Dabei werden deklarativ definierte Werte für die gesendeten Daten, Abfrageparameter oder abzurufenden Daten verwendet. (Geerbt von DataConnection)
Execute(XPathNavigator, XPathNavigator, XPathNavigator)	Überschreibt die von der DataConnection Basisklasse geerbte StandardmethodeExecute(), um die Angabe einer anderen Zu übermittelnden Datenquelle, eines anderen Speicherorts zum Einfügen der zurückgegebenen Daten oder eines Speicherorts zum Einfügen eines zurückgegebenen Fehlertexts zu ermöglichen.
GenerateDataSetDiffGram()	Für eine Datenverbindung, die ein ADO .NET-DataSet-Objekt verwendet und ein DiffGram-Objekt zurückgibt, das alle Unterschiede zwischen der ursprünglichen und der aktuellen Version von Datenelementen identifiziert.

Gilt für:

Freigeben über