DataSource Класс

Определение

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

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

Представляет источник данных в шаблоне формы.

public ref class DataSource abstract

public abstract class DataSource

type DataSource = class

Public MustInherit Class DataSource

Наследование

Object

DataSource

Комментарии

Объект DataSource соответствует одному из источников хранимых данных, связанных с шаблоном формы InfoPath. Объект DataSource может представлять либо основной (main) источник данных шаблона формы, либо дополнительный источник данных, полученный из какого-либо внешнего источника данных с помощью связанного подключения к данным (в первом выпуске Microsoft InfoPath он называется адаптером данных). Работая с основным источником данных формы, он обеспечивает доступ к связанному XML-документу формы, тогда как работая с дополнительным источником данных, он обеспечивает доступ к данным, полученным из внешнего источника данных, например при запросе веб-службы.

Объект DataSource предоставляет свойства и методы, которые можно использовать для программного взаимодействия с хранимыми данными, а также для предоставления доступа к связанному подключению к данным для вторичных источников данных. Доступ DataSource к объекту DataSources можно получить с помощью свойства XmlForm класса .

Для вторичных источников данных объект выступает в качестве посредника между формой и подключением к данным, DataSource которое используется для получения данных из внешнего источника данных, например подключения к базе данных Microsoft Access или Microsoft SQL Server, файлу .xml или веб-службе XML. Тип используемого объекта подключения данных зависит от типа внешнего подключения данных, используемого для запроса данных. Объект DataSource предоставляет общий набор свойств и методов, которые можно использовать для всех типов объектов соединения данных, а каждый из объектов подключения к данным предоставляет собственный набор свойств и методов.

Microsoft InfoPath поддерживает следующие типы подключений к данным:

• Запрос на подключение или отправка с помощью объектов данных ActiveX (ADO), представленных объектами AdoQueryConnection и AdoSubmitConnection .
• Подключение к запросу или отправке к внешнему источнику данных, зарегистрированного в службе подключения к бизнес-данным (BDC) сервера под управлением SharePoint Foundation 2010 или SharePoint Server 2010, представленного объектами BdcQueryConnection или BdcSubmitConnection .
• Подключение для запроса или отправки в список SharePoint, представленный объектами Microsoft.Office.InfoPath.SharepointListRWQueryConnection или Microsoft.Office.InfoPath.SharepointListRWSubmitConnection .
• Подключение к веб-службе, представленной WebServiceConnection объектом .
• Подключение к запросу или отправке в XML-файл, представленный объектами FileQueryConnection и FileSubmitConnection .
• Подключение для отправки по электронной почте, представленное EmailSubmitConnection объектом .

Класс DataSource соответствует интерфейсу DataObject в объектной модели Microsoft InfoPath 2003.

Конструкторы

DataSource()

Представляет источник данных в шаблоне формы.

Свойства

Name	Возвращает имя связанного DataSource объекта.
QueryConnection	Возвращает ссылку на объект, связанный DataConnection с источником данных.
ReadOnly	Возвращает значение, указывающее, имеет ли источник данных состояние только для чтения.

Методы

CreateNavigator()	Возвращает XPathNavigator
GetNamedNodeProperty(XPathNavigator, String)	Возвращает значение именованного свойства для указанного узла XML, который должен быть узлом nonattribute в основном источнике данных.
SetNamedNodeProperty(XPathNavigator, String, String)	Задает значение именованного свойства для указанного узла XML, который должен быть узлом nonattribute в основном источнике данных.