Интерфейс XDocument

Статья
04/27/2010

Представляет базовый документ XML формы.

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

Синтаксис

'Декларация
<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(XDocumentWrapper))> _
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument
    Inherits _XDocument2, _XDocument
'Применение
Dim instance As XDocument

[CLSCompliantAttribute(false)] 
[CoClassAttribute(typeof(XDocumentWrapper))] 
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")] 
public interface XDocument : _XDocument2, _XDocument

Заметки

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

Использование элементов интерфейса _XDocument2 обеспечивает совместимость с InfoPath 2003. Для использования новых элементов, добавленных к объектной модели XDocument в Microsoft Office InfoPath 2007, таких как свойство _XDocument3.Permission, необходимо привести объект XDocument к типу _XDocument3. Дополнительные сведения см. в разделе Практическое руководство. Использование элементов Microsoft.Office.Interop.InfoPath.SemiTrust, несовместимых с InfoPath 2003.

Объект 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, в разделе

Практическое руководство. Доступ к данным приложений с помощью объектной модели InfoPath 2003.

См. также

Ссылка

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

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