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 对象的位置。
哈希标记的内部名称。名称由下列组件构成:前缀 |
范围名称 |
---|---|
从 Application 访问。提供 Item,用以访问它所包含的 XDocument 对象。 |
|
提供 XDocument,用于在 XML DOM 发生更改时访问源 XML 数据。 |
|
提供 XDocument,当在表单区域中单击按钮时,用以访问源 XML 数据。 |
|
提供 XDocument,当切换视图或合并表单时,用以访问源 XML 数据。 |
|
提供 XDocument,当加载或提交表单时,用以访问源 XML。 |
|
提供 XDocument,当版本升级时,用以访问源 XML。 |
|
提供 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 对象模型访问应用程序数据.