DataConnection (Clase)
Representa la clase base de la que deriva cada tipo específico de conexión de datos.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)
Sintaxis
Public MustInherit Class DataConnection
Dim instance As DataConnection
public abstract class DataConnection
Comentarios
Cada conexión de datos se usa para recuperar datos (que se encuentran en el origen de datos principal o en un origen de datos secundario) o para enviar datos.
Una conexión de datos utilizada para recuperar o enviar datos en el origen de datos principal pertenecerá a uno de los siguientes tipos de objeto de conexión de datos:
Objetos AdoQueryConnection o AdoSubmitConnection
Objeto WebServiceConnection
Una conexión de datos utilizada para recuperar datos del origen de datos secundario corresponderá a uno de los tipos de objeto de conexión de datos siguientes:
ADOQueryConnection
Objeto WebServiceConnection
Objeto FileQueryConnection
Una conexión de datos utilizada sólo para enviar datos corresponderá a uno de los tipos de objetos de conexión de datos siguientes:
Objeto EmailSubmitConnection
Objeto FileSubmitConnection
Objeto WebServiceConnection
Para obtener acceso a un objeto DataConnection para un tipo de conexión de datos concreto, se usa el objeto DataConnectionCollection asociado a la plantilla de formulario. Para obtener acceso al objeto DataConnectionCollection, se usa la propiedad DataConnections de la clase XmlForm.
Para usar las propiedades o métodos del objeto devuelto desde la colección DataConnectionCollection, debe convertir dicho objeto en el tipo que representa el tipo de conexión de datos con el que está trabajando y poder obtener acceso a sus miembros. Por ejemplo, para trabajar con un objeto AdoQueryConnection (que representa una conexión de datos para recuperar datos de una base de datos de Access o SQL Server), debe convertir el objeto devuelto de la colección DataConnectionCollection como se muestra en los siguientes ejemplos.
// Get the Employees connection from the
// DataConnections collection.
AdoQueryConnection myAdoQueryConnection =
(AdoQueryConnection)(this.DataConnections["Employees"]);
' Get the Employees connection from the
' DataConnections collection.
Dim myAdoQueryConnection As AdoQueryConnection = _
DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)
Para obtener más información sobre el trabajo con conexiones de datos, vea Cómo: Obtener acceso a orígenes de datos externos.
Jerarquía de herencia
System.Object
Microsoft.Office.InfoPath.DataConnection
Clases derivadas
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
DataConnection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)