Интерфейс XDocument

Статья
04/27/2010

Представляет основной XML-документ формы Microsoft Office InfoPath.

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

Синтаксис

'Декларация
<GuidAttribute("096CD6A8-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(XDocumentClass))> _
Public Interface XDocument
    Inherits _XDocument2, _XDocumentEventSink2_Event
'Применение
Dim instance As XDocument

[GuidAttribute("096CD6A8-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(XDocumentClass))] 
public interface XDocument : _XDocument2, _XDocumentEventSink2_Event

Заметки

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

Объект XDocument является ключевым элементом объектной модели InfoPath и реализует свойства, методы и события, которые могут использоваться для программного взаимодействия с исходными XML-данными формы и для манипуляции ими.

Несмотря на то, что доступ к объекту XDocument возможен из коллекции XDocumentsCollection, чаще всего вместо прохождения коллекции для доступа к нему используется экземпляр переменной thisXDocument, создаваемый в методе _Startup проекта с управляемым кодом.

Исходные XML-данные формы принимают вид объектной модели документа XML DOM, для доступа к которой используется свойство DOM. Кроме того, объект XDocument предоставляет ряд свойств, посредством которых можно получить информацию о форме и XML-документе, лежащем в ее основе. Он также реализует несколько методов, которые могут применяться к форме, например, печать, сохранение и отправка. Объект XDocument предоставляет несколько событий, позволяющих обрабатывать различные действия на уровне формы, например, загрузка формы, переключение представлений и операция объединения.

Пример

Исходные XML-данные формы принимают вид объектной модели документа XML DOM, для доступа к которой используется свойство DOM объекта XDocument. Кроме того, объект XDocument предоставляет ряд свойств, посредством которых можно получить информацию о форме и XML-документе, лежащем в ее основе. Например, следующий код с помощью свойства IsDirty проверяет, вносились ли изменения в данные формы:

if (thisXDocument.IsDirty)
{
   thisXDocument.UI.Alert("Form has been changed.");
}
else
{
   thisXDocument.UI.Alert("Form has not been changed.");
}

В дополнение к сведениям о форме и XML-документе, лежащем в ее основе, объект XDocument предоставляет ряд методов для таких операций с формой, как печать, сохранение и отправка. Объект также предоставляет несколько событий, позволяющих обрабатывать различные действия на уровне формы, например, загрузка формы, переключение представлений и операция объединения.

Другой пример работы с объектом XDocument см. в статье

How to: Access Application Data Using the InfoPath 2003 Object Model.

См. также

Ссылка

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

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