Интерфейс DataAdaptersCollection

Статья
04/27/2010

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

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

Синтаксис

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

Заметки

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

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

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

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

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

ADOAdapterObject
SharepointListAdapterObject
WebServiceAdapterObject
XMLFileAdapterObject

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

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

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

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

Пример

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

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

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

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

См. также

Ссылка

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

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