DataAdaptersCollection Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public interface class DataAdaptersCollection : Microsoft::Office::Interop::InfoPath::SemiTrust::DataAdapters

[System.Runtime.InteropServices.Guid("096cd692-0786-11d1-95fa-0080c78ee3bb")]
public interface DataAdaptersCollection : Microsoft.Office.Interop.InfoPath.SemiTrust.DataAdapters

type DataAdaptersCollection = interface
    interface DataAdapters

Public Interface DataAdaptersCollection
Implements DataAdapters

Atributos

GuidAttribute

Implementaciones

DataAdapters

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.<span class="label">DataAdapters</span>["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:

<span class="label">DataAdapters</span> dataAdapters;
XMLFileAdapterObject xmlFileAdapterObject;

dataAdapters = thisXDocument.<span class="label">DataAdapters</span>; 
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);
 }
}

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. Para obtener información sobre la interfaz COM, incluido un vínculo a las descripciones de sus miembros, consulteDataAdapters .

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 usado para recuperar datos del 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 mediante la DataAdapters propiedad del XDocument objeto .

Nota: Para usar propiedades o métodos de un objeto de adaptador de datos, es necesario convertir el objeto devuelto desde el objeto DataAdaptersCollection al adaptador de datos específico que representa para poder acceder 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.

Propiedades

Count	Obtiene el número de adaptadores de datos de DataAdaptersCollection la colección. (Heredado de DataAdapters)
Item[Object]	Obtiene una referencia al objeto de adaptador de datos especificado de la colección, en función de la DataAdaptersCollection posición o el nombre. (Heredado de DataAdapters)

Métodos

GetEnumerator()

Obtiene un IEnumerator que recorre en iteración todas las entradas del DataAdaptersEnumerator objeto . (Heredado de DataAdapters)