DataConnectionCollection (Clase)
Contiene un objeto de conexión de datos correspondiente a cada conexión de datos utilizada en una plantilla de formulario.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)
Sintaxis
<DefaultMemberAttribute("Item")> _
Public MustInherit Class DataConnectionCollection
Implements IEnumerable
Dim instance As DataConnectionCollection
[DefaultMemberAttribute("Item")]
public abstract class DataConnectionCollection : IEnumerable
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 tener acceso a una instancia de la clase DataConnectionCollection asociada a una plantilla de formulario, 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.DataConnectionCollection
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
DataConnectionCollection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)