WebServiceConnection (Clase)

Representa una conexión a un servicio Web.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

Public MustInherit Class WebServiceConnection
    Inherits DataConnection

Dim instance As WebServiceConnection

public abstract class WebServiceConnection : DataConnection

Comentarios

La clase WebServiceConnection representa una conexión de datos creada en InfoPath con el Asistente para la conexión de datos que especifica toda la información necesaria para recuperar y enviar datos a un origen de datos externo mediante un servicio Web.

El objeto WebServiceConnection proporciona propiedades que se pueden utilizar para obtener y establecer información sobre las cadenas de entradas y operaciones de una conexión de datos. También proporciona una propiedad para obtener la dirección URL del archivo WSDL (Web Services Description Language) del servicio web XML.

Se puede tener acceso al objeto WebServiceConnection asociado a la conexión de datos mediante la propiedad DataConnections de la clase XmlForm para devolver la conexión de la colección DataConnectionCollection de la plantilla de formulario.

Además del método Execute predeterminado heredado de la clase base DataConnection que realiza una operación de consulta o envío con los valores que se definieron declarativamente en el modo de diseño de plantillas de formulario en InfoPath, la clase WebServiceConnection proporciona también el método WebServiceConnection.Execute, que permite especificar otro origen de datos para el envío, otra ubicación para insertar los datos devueltos, y un método para recuperar los errores devueltos por la conexión.

La clase WebServiceConnection corresponde a la interfaz WebServiceAdapterObject del modelo de objetos de Microsoft Office InfoPath 2003.

Ejemplo

En el ejemplo siguiente, se establece una referencia al objeto WebServiceConnection que representa la conexión denominada "Main query"; para ello, se pasa el nombre a la propiedad Item de la clase DataConnectionCollection y, a continuación, se convierte el objeto devuelto en el tipo WebServiceConnection.[C#]

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

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

Una vez establecida la referencia, podrá utilizar las propiedades del objeto WebServiceConnection como se muestra en el ejemplo siguiente, que establece una variable de cadena en el valor devuelto por la propiedad ServiceUrl.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

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

Jerarquía de herencia

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

Seguridad de subprocesos

Todos los miembros estáticos públicos (compartidos en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para los subprocesos.

Vea también

Referencia

WebServiceConnection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)