Clase DataConnectionCollection
Contiene un objeto de conexión de datos correspondiente a cada conexión de datos utilizada en una plantilla de formulario.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.DataConnectionCollection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class DataConnectionCollection _
Implements IEnumerable
'Uso
Dim instance As DataConnectionCollection
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:
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:
SharePointListRWQueryConnection
Nota
El objeto SharepointListQueryConnection utilizado en las versiones anteriores de InfoPath ha sido suplantado.
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:
Para obtener acceso a un objeto DataConnection para un tipo particular de conexión de datos, utilice el objeto DataConnectionCollection asociado con la plantilla del formulario. Para obtener acceso al objeto DataConnectionCollection, use 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.
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.