DataConnectionCollection Clase

Definición

Espacio de nombres:

Microsoft.Office.InfoPath

Ensamblado:

Microsoft.Office.InfoPath.dll

Contiene un objeto de conexión de datos correspondiente a cada conexión de datos utilizada en una plantilla de formulario.

public ref class DataConnectionCollection abstract : System::Collections::IEnumerable

public abstract class DataConnectionCollection : System.Collections.IEnumerable

type DataConnectionCollection = class
    interface IEnumerable

Public MustInherit Class DataConnectionCollection
Implements IEnumerable

Herencia

Object

DataConnectionCollection

Implementaciones

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:

• AdoQueryConnection
• AdoSubmitConnection
• 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
• BdcQueryConnection
• FileQueryConnection
• SharePointListRWQueryConnection
• WebServiceConnection

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:

• BdcSubmitConnection
• EmailSubmitConnection
• FileSubmitConnection
• SharePointListRWSubmitConnection
• WebServiceConnection

Para acceder a un DataConnection objeto para un tipo determinado de conexión de datos, use el DataConnectionCollection objeto asociado a la plantilla de formulario. Para obtener acceso al DataConnectionCollection objeto, use la DataConnections propiedad de la XmlForm clase .

Para usar las propiedades o métodos del objeto devuelto desde DataConnectionCollection, debe convertir ese objeto en el tipo que representa el tipo de conexión de datos con el que está trabajando para poder acceder a esos miembros. Por ejemplo, para trabajar con un AdoQueryConnection objeto (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 , DataConnectionCollection como se muestra en los ejemplos siguientes.

// 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.

Constructores

DataConnectionCollection()

Contiene un objeto de conexión de datos correspondiente a cada conexión de datos utilizada en una plantilla de formulario.

Propiedades

Count	Obtiene el recuento del número de objetos de DataConnection la colección.
Item[Int32]	Obtiene una referencia al objeto especificado DataConnection de la colección por valor de índice.
Item[String]	Obtiene una referencia al objeto especificado DataConnection de la colección por nombre.

Métodos

GetEnumerator()

Obtiene un IEnumerator objeto que recorre en iteración todas las entradas de la colección.