Share via


XDocument 接口

代表表单的基础 XML 文档。

命名空间:  Microsoft.Office.Interop.InfoPath.SemiTrust
程序集:  Microsoft.Office.Interop.InfoPath.SemiTrust(位于 Microsoft.Office.Interop.InfoPath.SemiTrust.dll 中)

语法

声明
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument _
    Inherits _XDocument2, _XDocument
用法
Dim instance As XDocument
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : _XDocument2, 
    _XDocument

备注

此类型是用于 Coclass(托管代码需要此 Coclass 来实现 COM 互操作性)的包装。使用此类型来访问由此 Coclass 实现的 COM 接口。有关 COM 接口的信息(包括指向其成员说明的链接),请参阅_XDocument2.

使用_XDocument2接口的成员提供与 InfoPath 2003 的兼容性。若要使用已添加到 Microsoft InfoPath 2010 年的XDocument对象模型如_XDocument3.Permission属性的新成员,必须强制转换为_XDocument3类型的XDocument对象。有关详细信息,请参阅如何:使用与 InfoPath 2003 不兼容的 Microsoft.Office.Interop.InfoPath.SemiTrust 成员

XDocument 对象是 InfoPath 对象模型中的关键对象,该对象提供的属性、方法以及事件可以用来以编程的方式与表单的源 XML 数据进行交互,并操纵这些数据。

尽管可以使用 XDocumentsCollection 集合来访问 XDocument 对象,但是,在大多数情况下,将从在托管代码项目的 _Startup 方法中实例化的 thisXDocument 变量访问它,而无需使用该集合。

表单的源 XML 数据采取 XML 文档对象模型 (DOM) 的格式,可以通过 DOM 属性来访问。XDocument 对象还提供许多属性,用以获取有关表单及其基础 XML 文档的信息。它还提供许多可用在表单上的方法,如打印、保存和提交。XDocument 对象还提供许多事件,用来响应在表单级别上发生的各种操作,如加载表单、切换视图或合并操作。

访问 XDocument 对象

可以在 InfoPath 对象模型中的许多位置访问 XDocument 对象。下表总结了可在其中使用 XDocument 对象的位置。

哈希标记的内部名称。名称由下列组件构成:前缀

范围名称

XDocumentsCollection

Application 访问。提供 Item,用以访问它所包含的 XDocument 对象。

DataDOMEventObject

提供 XDocument,用于在 XML DOM 发生更改时访问源 XML 数据。

DocActionEventObject

提供 XDocument,当在表单区域中单击按钮时,用以访问源 XML 数据。

DocEventObject

提供 XDocument,当切换视图或合并表单时,用以访问源 XML 数据。

DocReturnEventObject

提供 XDocument,当加载或提交表单时,用以访问源 XML。

VersionUpgradeEventObject

提供 XDocument,当版本升级时,用以访问源 XML。

WindowObject

提供 XDocument,用以访问与该窗口相关联的 XDocument 对象。

示例

表单的源 XML 数据采取 XML 文档对象模型 (DOM) 的格式,可以通过 XDocument 对象的 DOM 属性来访问。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 命名空间