DataAdaptersCollection Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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::DataAdapters
[System.Runtime.InteropServices.Guid("096CD692-0786-11D1-95FA-0080C78EE3BB")]
public interface DataAdaptersCollection : Microsoft.Office.Interop.InfoPath.DataAdapters
type DataAdaptersCollection = interface
interface DataAdapters
Public Interface DataAdaptersCollection
Implements DataAdapters
- Derivado
- Atributos
- Implementaciones
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;
dataAdapters = thisXDocument.<span class="label">DataAdapters</span>;
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);
}
Comentarios
Este tipo es un contenedor para una interfaz COM implementada por una coclase que requiere el código administrado para la interoperabilidad con COM. Para acceder a los miembros que especifica esta interfaz, utilice el tipo que contiene la coclase que implementa esta interfaz. Para obtener información sobre ese tipo, incluidos el uso, los comentarios y los ejemplos, 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:
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:
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 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 sobre cómo trabajar con adaptadores de datos, consulte Cómo: Acceder a orígenes de datos externos.
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 de la DataAdapters colección. (Heredado de DataAdapters) |