Classe WebServiceConnection

Rappresenta una connessione a un servizio Web XML.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustInherit Class WebServiceConnection
    Inherits DataConnection

Dim instance As WebServiceConnection

public abstract class WebServiceConnection : DataConnection

Osservazioni

La classe WebServiceConnection rappresenta una connessione dati creata in InfoPath utilizzando la Connessione guidata dati, che specifica tutte le informazioni necessarie per il recupero dei dati da e l'invio dei dati a un'origine dati esterna utilizzando un servizio Web.

L'oggetto WebServiceConnection implementa proprietà che possono essere utilizzate per ottenere e impostare informazioni sulle stringhe degli elementi input e operation della connessione dati. Implementa inoltre una proprietà che consente di ottenere l'URL (Uniform Resource Locator) del file WSDL (Web Services Description Language) del servizio Web XML.

È possibile accedere all'oggetto WebServiceConnection associato alla connessione dati utilizzando la proprietà DataConnections della classe XmlForm per restituire la connessione dall'insieme DataConnectionCollection del modello di modulo.

Oltre al metodo Execute predefinito ereditato dalla classe di base DataConnection, che consente di eseguire un'operazione di query o di invio utilizzando i valori definiti in modo dichiarativo in modalità progettazione del modello di modulo di InfoPath, la classe WebServiceConnection implementa anche il metodo WebServiceConnection.Execute, che consente di specificare un'origine diversa dei dati da inviare, un percorso diverso in cui inserire i dati restituiti e un modo per recuperare gli errori restituiti dalla connessione.

La classe WebServiceConnection corrisponde all'interfaccia WebServiceAdapterObject del modello a oggetti di Microsoft Office InfoPath 2003.

Esempio

Nell'esempio seguente viene impostato un riferimento all'oggetto WebServiceConnection che rappresenta la connessione denominata "Main query" passando il nome alla proprietà Item della classe DataConnectionCollection e quindi eseguendo il cast dell'oggetto restituito al tipo WebServiceConnection. [C#]

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

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

Dopo avere impostato il riferimento, è possibile utilizzare le proprietà dell'oggetto WebServiceConnection come illustrato nell'esempio seguente, in cui una variabile stringa viene impostata sul valore restituito dalla proprietà ServiceUrl.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

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

Gerarchia di ereditarietà

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

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Membri WebServiceConnection
Spazio dei nomi Microsoft.Office.InfoPath