DataAdaptersCollection Interface

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Contém um objeto adaptador de dados correspondente a cada conexão de dados usada em um formulário do 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

Microsoft.Office.Interop.InfoPath.DataAdaptersCollectionClass

Atributos

GuidAttribute

Implementações

DataAdapters

Exemplos

No exemplo a seguir, um objeto ADOAdapter conectado à tabela Employees do banco de dados Northwind é recuperado da coleção DataAdapters :

// retrieve the Employees Adapter from the DataAdapters collection
ADOAdapter employeesDA = (ADOAdapter)thisXDocument.<span class="label">DataAdapters</span>["Employees"];

No exemplo a seguir, um documento XML chamado "form1", disponível como uma conexão de dados de arquivo XML, é recuperado da coleção DataAdapters . Várias propriedades da conexão são exibidas em caixas de mensagens:

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

Comentários

This type is a wrapper for a COM interface implemented by a coclass that is required by managed code for COM interoperability. To access the members specified by this interface, use the type that wraps the coclass that implements this interface. Para obter informações sobre esse tipo, incluindo uso, observações e exemplos, consulteDataAdapters.

Cada conexão de dados é usada para recuperar dados (inseridos na fonte de dados principal ou em uma fonte de dados secundária) ou para enviar dados.

Uma conexão de dados usada para recuperar dados para a fonte de dados principal corresponderá a um dos seguintes tipos de objeto do adaptador de dados:

• ADOAdapterObject
• WebServiceAdapterObject

Observação: um objeto ADOAdapter usado para recuperar dados para a fonte de dados principal também pode enviar dados.

Uma conexão de dados usada para recuperar dados de uma fonte de dados secundária corresponderá a um dos seguintes tipos de objeto do adaptador de dados:

• ADOAdapterObject
• SharepointListAdapterObject
• WebServiceAdapterObject
• XMLFileAdapterObject

Uma conexão de dados usada apenas para enviar dados corresponderá a um dos seguintes tipos de objeto do adaptador de dados:

• EmailAdapterObject
• DAVAdapterObject
• HWSAdapterObject
• WebServiceAdapterObject

A coleção DataAdapters pode ser acessada usando a DataAdapters propriedade do XDocument objeto.

Observação: para usar propriedades ou métodos de um objeto adaptador de dados, é necessário lançar o objeto retornado do objeto DataAdaptersCollection para o adaptador de dados específico que ele representa antes que você possa acessar esses membros. Para obter mais informações sobre como trabalhar com adaptadores de dados, consulte Como acessar fontes de dados externas

Propriedades

Count	Obtém o número de adaptadores de dados na DataAdaptersCollection coleção. (Herdado de DataAdapters)
Item[Object]	Obtém uma referência ao objeto adaptador de dados especificado da DataAdaptersCollection coleção, com base na posição ou nome. (Herdado de DataAdapters)

Métodos

GetEnumerator()

Obtém um IEnumerator que itera em todas as entradas da DataAdapters coleção. (Herdado de DataAdapters)