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.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Sintassi

<CoClassAttribute(GetType(DataAdaptersCollectionWrapper))> _
<GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")> _
<CLSCompliantAttribute(False)> _
Public Interface DataAdaptersCollection
    Inherits DataAdapters

Dim instance As DataAdaptersCollection

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

Osservazioni

Questo tipo è un wrapper per una coclasse richiesta dal codice gestito per l'interoperabilità COM. Utilizzare questo tipo per accedere ai membri dell'interfaccia COM implementata dalla coclasse. Per informazioni sull'interfaccia COM e un collegamento alle descrizioni dei relativi membri, 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 tramite il modello a oggetti di InfoPath 2003.

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 tramite il modello a oggetti di InfoPath 2003.

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

Vedere anche

Riferimenti

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

Condividi tramite