WebServiceConnection-Klasse

Artikel
04/27/2010

Stellt eine Verbindung mit einem XML-Webdienst dar.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustInherit Class WebServiceConnection
    Inherits DataConnection
'Usage
Dim instance As WebServiceConnection

public abstract class WebServiceConnection : DataConnection

Hinweise

Die WebServiceConnection-Klasse stellt eine Datenverbindung dar, die in InfoPath mithilfe desDatenverbindungs-Assistenten erstellt wurde und alle erforderlichen Informationen zum Abrufen von Daten von einer externen Datenquelle und zum Senden von Daten an eine externe Datenquelle mithilfe eines Webdienstes angibt.

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 aus der DataConnectionCollection-Auflistung der Formularvorlage zurückzugeben.

Zusätzlich zu der standardmäßigen Execute-Methode, die von der DataConnection-Basisklasse geerbt wird und einen Sende- oder Abfragevorgang mithilfe der im InfoPath-Entwurfsmodus für Formularvorlagen deklarativ definierten Werte ausführt, stellt die WebServiceConnection-Klasse auch die WebServiceConnection.Execute-Methode bereit, mit der Sie eine andere zu sendende Datenquelle, einen anderen Speicherort zum Einfügen der zurückgegebenen Daten und eine Möglichkeit zum Abrufen der von der Verbindung zurückgegebenen Fehler angeben können.

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

Beispiel

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

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, wie im folgenden Beispiel gezeigt, verwenden, mit dem eine Zeichenfolgenvariable auf den von der ServiceUrl-Eigenschaft zurückgegebenen Wert festgelegt wird.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

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

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.WebServiceConnection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

WebServiceConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über