Interfaccia DataAdaptersCollection

Articolo
04/27/2010

Include un oggetto adattatore dati corrispondente a ogni connessione dati utilizzata in un modulo di Microsoft Office InfoPath 2007.

Spazio dei nomi: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Sintassi

<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

Osservazioni

Questo tipo è un wrapper per un'interfaccia COM implementata da una coclasse richiesta dal codice gestito per l'interoperabilità COM. Per accedere ai membri specificati dall'interfaccia, utilizzare il tipo che contiene la coclasse che implementa l'interfaccia. Per informazioni sul tipo, inclusi dati sull'utilizzo, osservazioni ed esempi, vedere DataAdapters.

Ogni connessione dati viene utilizzata per il recupero dei dati (inseriti nell'origine dati principale o in un'origine dati secondaria) oppure per l'invio dei dati.

Una connessione dati utilizzata per il recupero dei dati relativi all'origine dati principale corrisponderà a uno dei tipi di oggetto adattatore dati seguenti:

Nota:
Un oggetto ADOAdapter utilizzato per il recupero dei dati relativi all'origine dati principale consente inoltre l'invio dei dati.

Una connessione dati utilizzata per il recupero dei dati relativi a un'origine dati secondaria corrisponderà a uno dei tipi di oggetto adattatore dati seguenti:

ADOAdapterObject
SharepointListAdapterObject
WebServiceAdapterObject
XMLFileAdapterObject

Una connessione dati utilizzata esclusivamente per l'invio dei dati corrisponderà a uno dei tipi di oggetto adattatore dati seguenti:

È possibile accedere all'insieme DataAdapters tramite la proprietà DataAdapters dell'oggetto XDocument.

Nota:
Per utilizzare proprietà o metodi di un oggetto adattatore dati, è necessario eseguire il cast dell'oggetto restituito dall'oggetto DataAdaptersCollection all'adattatore dati specifico da esso rappresentato prima di accedere a tali membri. Per ulteriori informazioni sull'utilizzo degli adattatori dati, vedere Procedura: Accedere a origini dati esterne.

Esempio

Nell'esempio seguente viene recuperato dall'insieme DataAdapters un oggetto ADOAdapter connesso alla tabella Employees del database Northwind:

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

Nell'esempio seguente, un documento XML denominato "form1", disponibile come connessione dati al file XML, viene recuperato dall'insieme DataAdapters. Le varie proprietà della connessione vengono visualizzate in finestre di messaggio:

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);
}

Vedere anche

Riferimenti

Membri DataAdaptersCollection
Spazio dei nomi Microsoft.Office.Interop.InfoPath

Condividi tramite