Интерфейс DataAdaptersCollection

Статья
04/27/2010

Содержит объект адаптера данных, соответствующий каждому подключению к данным, используемому в форме Microsoft Office InfoPath 2007.

Пространство имен: Microsoft.Office.Interop.InfoPath
Сборка: Microsoft.Office.Interop.InfoPath (в microsoft.office.interop.infopath.dll)

Синтаксис

'Декларация
<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

Заметки

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

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

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

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

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

ADOAdapterObject
SharepointListAdapterObject
WebServiceAdapterObject
XMLFileAdapterObject

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

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

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

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

Пример

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

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

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

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

См. также

Ссылка

Члены DataAdaptersCollection
Пространство имен Microsoft.Office.Interop.InfoPath

Поделиться через