Clase WebServiceConnection
Representa una conexión a un servicio Web.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.WebServiceConnection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class WebServiceConnection _
Inherits DataConnection
'Uso
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.
Ejemplos
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.
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()
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.