Interfaz DataAdaptersCollection

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

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
<GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DataAdaptersCollection _
    Inherits DataAdapters
'Uso
Dim instance As DataAdaptersCollection

[GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")]
public interface DataAdaptersCollection : DataAdapters

Comentarios

Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Encontrará información sobre la interfaz COM, así como vínculos a las descripciones de sus miembros, enDataAdapters.

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:

• ADOAdapterObject

• WebServiceAdapterObject

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:

• ADOAdapterObject

• SharepointListAdapterObject

• WebServiceAdapterObject

• XMLFileAdapterObject

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

• EmailAdapterObject

• DAVAdapterObject

• HWSAdapterObject

• WebServiceAdapterObject

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 los adaptadores de datos, vea Cómo: Obtener acceso a orígenes de datos externos usando el modelo de objetos de InfoPath 2003.

Ejemplos

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;
XMLFileAdapterObject xmlFileAdapterObject;

dataAdapters = thisXDocument.DataAdapters; 
xmlFileAdapterObject = dataAdapters["form1"] as XMLFileAdapterObject;

if (xmlFileAdapterObject == null)
{
 thisXDocument.UI.Alert("The DataAdapter does not exist or is not an XMLFileAdapterObject.");
}
else
{
 thisXDocument.UI.Alert("XML file adapter" + "\n\n" + "Name: " + xmlFileAdapterObject.Name + "\n" + "QueryAllowed: " + xmlFileAdapterObject.QueryAllowed+ "\n" + "SubmitAllowed: " + xmlFileAdapterObject.SubmitAllowed+ "\n" + "FileURL: " + xmlFileAdapterObject.FileURL);

 // Perform the query.
 try
 {
  xmlFileAdapterObject.Query();
 }
 catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to query.\n\n" + ex.Message);
 }

 // Perform the submit.
 try
 {
  xmlFileAdapterObject.Submit();
 }
 catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to submit.\n\n" + ex.Message);
 }
}

Vea también

Referencia

Miembros DataAdaptersCollection

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust