Compartir a través de


DataAdaptersCollection (Interfaz)

Contiene un objeto de adaptador de datos correspondiente a cada conexión de datos utilizada en un formulario de Microsoft Office InfoPath 2007.

Espacio de nombres: Microsoft.Office.Interop.InfoPath
Ensamblado: Microsoft.Office.Interop.InfoPath (en microsoft.office.interop.infopath.dll)

Sintaxis

<GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(DataAdaptersCollectionClass))> _
Public Interface DataAdaptersCollection
    Inherits DataAdapters

Dim instance As DataAdaptersCollection
[GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(DataAdaptersCollectionClass))] 
public interface DataAdaptersCollection : DataAdapters

Comentarios

Este tipo es un contenedor para una interfaz COM implementada por una coclase que necesita el código administrado para su interoperabilidad COM. Para obtener acceso a los miembros especificados por esta interfaz, use el tipo que contiene la coclase que implementa esta interfaz. Para obtener información sobre el tipo, incluido su uso, así como observaciones y ejemplos, vea DataAdapters.

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 datos del origen de datos principal corresponderá a uno de los tipos de objeto de adaptador de datos siguientes:

Nota:

Un objeto ADOAdapter que se utiliza para recuperar datos para el origen de datos principal también puede enviar datos.

Una conexión de datos utilizada para recuperar datos del origen de datos secundario corresponderá a uno de los tipos de objeto de adaptador de datos siguientes:

Una conexión de datos utilizada sólo para enviar datos corresponderá a uno de los tipos de objetos de adaptador de datos siguientes:

Se puede tener acceso a la colección DataAdapters usando la propiedad DataAdapters del objeto XDocument.

Nota:

Para utilizar propiedades o métodos de un objeto de adaptador de datos, es necesario convertir el objeto devuelto del objeto DataAdaptersCollection en el adaptador de datos específico que representa para poder tener acceso a esos miembros. Para obtener más información acerca de cómo trabajar con adaptadores de datos, consulte Cómo: Obtener acceso a orígenes de datos externos

Ejemplo

En el siguiente ejemplo, se recupera un objeto ADOAdapter conectado a la tabla Empleados de la base de datos Neptuno desde la colección DataAdapters:

// retrieve the Employees Adapter from the DataAdapters collection
ADOAdapter employeesDA = (ADOAdapter)thisXDocument.DataAdapters["Employees"];

En el siguiente ejemplo, se recupera un documento XML denominado "form1", disponible como una conexión de datos XML, desde la colección DataAdapters. En los cuadros de mensaje se muestran varias propiedades de la conexión:

DataAdapters dataAdapters;
dataAdapters = thisXDocument.DataAdapters; 
XMLFileAdapterObject queryXMLFile = (XMLFileAdapterObject)dataAdapters["form1"];
thisXDocument.UI.Alert("Query - XML file adapter"); 
thisXDocument.UI.Alert("Name: " + queryXMLFile.Name);
thisXDocument.UI.Alert("QueryAllowed: " + queryXMLFile.QueryAllowed);
thisXDocument.UI.Alert("SubmitAllowed: " + queryXMLFile.SubmitAllowed);
thisXDocument.UI.Alert("FileURL: " + queryXMLFile.FileURL);
// Perform the query.
try
 {
  queryXMLFile.Query();
 }
catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to query.\n\n" + ex.Message);
 }
// Perform the submit.
try
 {
  queryXMLFile.Submit();
 }
catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to submit.\n\n" + ex.Message);
}

Vea también

Referencia

DataAdaptersCollection (Miembros)
Microsoft.Office.Interop.InfoPath (Espacio de nombres)