XDocument 接口

定义

命名空间:

Microsoft.Office.Interop.InfoPath.SemiTrust

程序集:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

代表表单的基础 XML 文档。

public interface class XDocument : Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocument2

[System.Runtime.InteropServices.Guid("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocument2

type XDocument = interface
    interface _XDocument2
    interface _XDocument

Public Interface XDocument
Implements _XDocument2

属性

GuidAttribute

实现

_XDocument2

示例

表单的源 XML 数据采用 XML 文档对象模型的形式， (DOM) ，可通过 DOMXDocument 对象的 属性访问该模型。 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 对象模型) 。

注解

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

使用 _XDocument2 接口成员可与 InfoPath 2003 兼容。 若要在 Microsoft InfoPath 2010（如 属性）Permission中使用添加到 XDocument 对象模型的新成员，必须将 XDocument 对象_XDocument3强制转换为 类型。 有关详细信息，请参阅如何：使用与 InfoPath 2003 不兼容的对象模型成员。

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

虽然可以使用 集合访问 XDocumentsCollectionXDocument 对象，但在大多数情况下，你将从托管代码项目的 _Startup 方法实例化的 thisXDocument 变量访问它，而无需通过集合。

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

访问 XDocument 对象

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

XDocumentsCollection	从 Application访问。 提供 Item[Object] 用于访问它包含的 XDocument 对象。
DataDOMEventObject	用于 XDocument 在 XML DOM 更改期间访问源 XML 数据。
DocActionEventObject	提供 XDocument 在窗体区域中单击按钮期间访问源 XML 数据。
DocEventObject	用于 XDocument 在切换视图或表单合并操作期间访问源 XML 数据。
DocReturnEventObject	用于 XDocument 在加载或提交表单期间访问源 XML。
VersionUpgradeEventObject	提供 XDocument 用于在版本升级操作期间访问源 XML 的功能。
WindowObject	提供 XDocument 用于访问与窗口关联的 XDocument 对象。

属性

DataAdapters	获取对 DataAdaptersCollection 与窗体关联的集合的引用。 (继承自 _XDocument2)
DataObjects	获取对 DataObjectsCollection 与窗体关联的集合的引用。 (继承自 _XDocument2)
DOM	获取一个对表单的基础 XML 文档的引用，采用 XML 文档对象模型 (DOM) 形式。 (继承自 _XDocument2)
Errors	获取对 ErrorsCollection 与窗体关联的 的引用。 (继承自 _XDocument2)
Extension	获取一个对全局脚本对象的引用，该对象公开表单的主要表单代码文件中所包含的函数和全局变量。 (继承自 _XDocument2)
IsDirty	获取一个值，该值指示表单中的数据自上次保存之后是否被修改过。 (继承自 _XDocument2)
IsDOMReadOnly	获取一个值，该值指示表单的基础 XML 文档中的数据已被设置为只读状态。 (继承自 _XDocument2)
IsNew	获取一个值，该值指示新创建的表单是否已保存。 (继承自 _XDocument2)
IsReadOnly	获取一个值，该值指示表单是否处于只读模式。 (继承自 _XDocument2)
IsRecovered	获取一个值，该值指示表单上次是否是由自动恢复保存操作保存的。 (继承自 _XDocument2)
IsSigned	获取一个值，该值指示是否已经对表单进行过数字签名。 (继承自 _XDocument2)
Language	获取或设置表单的默认语言代码。 (继承自 _XDocument2)
QueryAdapter	获取一个与表单相关联的数据适配器对象的引用。 (继承自 _XDocument2)
Role	获取或设置用户的当前角色。 (继承自 _XDocument2)
SignedDataBlocks	获取对 SignedDataBlocksCollection 与 对象关联的集合的 XDocument 引用。 (继承自 _XDocument2)
Solution	获取对 SolutionObject 与窗体关联的 对象的引用。 (继承自 _XDocument2)
UI	返回对 UIObject 对象的引用。 (继承自 _XDocument2)
URI	获取表单的统一资源标识符 (URI)。 (继承自 _XDocument2)
Util	获取对 UtilObject 对象的引用。 (继承自 _XDocument2)
View	获取对与窗体关联的 的 ViewObject 引用。 (继承自 _XDocument2)
ViewInfos	获取对 ViewInfosCollection 与窗体关联的集合的引用。 (继承自 _XDocument2)

方法

CreateDOM()	在内存中新建 XML 文档对象模型 (DOM) 实例。 (继承自 _XDocument2)
GetDataVariable(Int32)	获取指定变量的值，该变量是作为处理指令属性存储在表单的基础 XML 文档中的预定义变量。 (继承自 _XDocument2)
GetDOM(String)	获取对 XML 文档对象模型 (DOM) 与对象XDocument关联的指定DataSourceObject对象的引用。 (继承自 _XDocument2)
GetNamedNodeProperty(Object, String, String)	获取指定 XML 节点的命名属性的值，该节点必须是主数据源中的 nonattribute 节点。 (继承自 _XDocument2)
ImportDOM(IXMLDOMDocument)	将指定的 XML 数据导入当前表单。 (继承自 _XDocument2)
ImportFile(String)	将指定表单导入当前表单。 (继承自 _XDocument2)
PrintOut()	按照表单内容在窗口（该窗口与表单的活动视图相对应）中的显示效果打印该表单内容。 (继承自 _XDocument2)
Query()	从表单的相关数据适配器对象中检索数据，并将数据存储到表单的基础 XML 文档对象模型 (DOM) 中。 (继承自 _XDocument2)
Save()	将表单保存到当前关联的统一资源定位器 (URL)。 (继承自 _XDocument2)
SaveAs(String)	将表单保存到指定的统一资源定位器 (URL)。 (继承自 _XDocument2)
SetDataVariable(Int32, String)	为作为表单基础 XML 文档中的处理指令属性而存储的预定义变量设置值。 (继承自 _XDocument2)
SetDirty(Boolean)	IsDirty设置 对象的 属性，该属性XDocument指示表单中的数据自上次保存以来是否已修改。 (继承自 _XDocument2)
SetNamedNodeProperty(IXMLDOMNode, String, String)	设置所提供 XML 节点的命名属性的值，该节点必须是主数据源中的 nonattribute 节点。 (继承自 _XDocument2)
Submit()	在表单中执行预定义的提交操作。 (继承自 _XDocument2)