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 SharepointListQueryConnection

• 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)