DataAdaptersCollection Интерфейс

Определение

Пространство имен:

Microsoft.Office.Interop.InfoPath.SemiTrust

Сборка:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Содержит объект адаптера данных, соответствующий каждому подключению к данным, используемому в форме 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

Атрибуты

GuidAttribute

Реализации

DataAdapters

Примеры

В следующем примере объект ADOAdapter, связанный с таблицей Employees базы данных Northwind, извлекается из семейства DataAdapters:

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

В следующем примере документ XML, называемый "form1", доступный в виде XML-файла подключения к данным, извлекается из семейства DataAdapters. Различные свойства подключения отображаются в окне сообщения:

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

Комментарии

Этот тип является оболочкой для компонентного класса, необходимого управляемому коду для взаимодействия с COM. Используйте этот тип для доступа к элементам интерфейса COM, реализованного этим компонентным классом. Сведения об интерфейсе COM, включая ссылку на описания его членов, см. в разделеDataAdapters .

Каждое подключение к данным используется для извлечения данных (вставленных в основной или вспомогательный источник данных) или для отправки данных.

Подключение к данным, используемое для извлечения данных для основного источника данных, соответствует одному из следующих типов объектов адаптера данных:

• ADOAdapterObject
• WebServiceAdapterObject

Примечание. Объект ADOAdapter, используемый для получения данных для источника данных main, также может отправлять данные.

Подключение к данным, используемое для извлечения данных для вспомогательного источника данных, соответствует одному из следующих типов объекта адаптера данных:

• ADOAdapterObject
• SharepointListAdapterObject
• WebServiceAdapterObject
• XMLFileAdapterObject

Подключение к данным, используемое только для отправки данных, соответствует одному из следующих типов объектов адаптера данных:

• EmailAdapterObject
• DAVAdapterObject
• HWSAdapterObject
• WebServiceAdapterObject

Доступ к коллекции DataAdapters можно получить с помощью DataAdapters свойства XDocument объекта .

Примечание. Чтобы использовать свойства или методы объекта адаптера данных, необходимо привести объект, возвращенный из объекта DataAdaptersCollection , к конкретному адаптеру данных, который он представляет, прежде чем вы сможете получить доступ к этим элементам. Дополнительные сведения о работе с адаптерами данных см. в разделе How to: Access External Data Sources Using the InfoPath 2003 Object Model.

Свойства

Count	Возвращает количество адаптеров данных в DataAdaptersCollection коллекции. (Унаследовано от DataAdapters)
Item[Object]	Возвращает ссылку на указанный объект адаптера DataAdaptersCollection данных из коллекции на основе позиции или имени. (Унаследовано от DataAdapters)

Методы

GetEnumerator()

Возвращает IEnumerator , который выполняет итерацию по всем записям в объекте DataAdaptersEnumerator . (Унаследовано от DataAdapters)