DataAdaptersCollection Интерфейс

Определение

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

Microsoft.Office.Interop.InfoPath

Сборка:

Microsoft.Office.Interop.InfoPath.dll

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

Производный

Microsoft.Office.Interop.InfoPath.DataAdaptersCollectionClass

Атрибуты

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

Комментарии

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

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

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

• ADOAdapterObject
• WebServiceAdapterObject

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

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

• ADOAdapterObject
• SharepointListAdapterObject
• WebServiceAdapterObject
• XMLFileAdapterObject

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

• EmailAdapterObject
• DAVAdapterObject
• HWSAdapterObject
• WebServiceAdapterObject

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

Примечание. Чтобы использовать свойства или методы объекта адаптера данных, необходимо привести объект, возвращенный объектом DataAdaptersCollection , к конкретному адаптеру данных, который он представляет, прежде чем вы сможете получить доступ к этим элементам. Дополнительные сведения о работе с адаптерами данных см. в разделе Практическое руководство. Доступ к внешним источникам данных.

Свойства

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

Методы

GetEnumerator()

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