_XDocumentEventSink2_Event.OnVersionUpgrade 事件

定义

命名空间:

Microsoft.Office.Interop.InfoPath.SemiTrust

程序集:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

当打开的 Microsoft InfoPath 表单的版本号早于它所基于的表单模板的版本号时发生。

public:
 event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnVersionUpgradeEventHandler ^ OnVersionUpgrade;

event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade;

member this.OnVersionUpgrade : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler 

Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler 

事件类型

_XDocumentEventSink2_OnVersionUpgradeEventHandler

示例

在以下示例中， DocumentVersion 对象的 和 SolutionVersion 属性 VersionUpgradeEventObject 用于显示表单和表单模板的版本号：

[InfoPathEventHandler(EventType=InfoPathEventType.<span class="label">OnVersionUpgrade</span>)]
public void OnVersionUpgrade(VersionUpgradeEvent e)
{
 thisXDocument.UI.Alert("The form version: " + e.DocumentVersion + 
  "\nThe form template version: " + e.SolutionVersion);
 e.ReturnStatus = true;
}

在以下示例中， DocumentVersion 对象的 和 SolutionVersion 属性 VersionUpgradeEventObject 用于显示表单和表单模板的版本号：

[InfoPathEventHandler(EventType=InfoPathEventType.<span class="label">OnVersionUpgrade</span>)]
public void OnVersionUpgrade(VersionUpgradeEvent e)
{
 thisXDocument.UI.Alert("The form version: " + e.DocumentVersion + 
  "\nThe form template version: " + e.SolutionVersion);
 e.ReturnStatus = true;
}

注解

此事件处理程序允许用户取消操作。

在 OnVersionUpgrade 事件期间，表单的基础 XML 文档设置为只读模式，且不会根据表单的相关联 XML 架构对其进行验证。 ReturnStatus如果 对象的 属性VersionUpgradeEventObject设置为 false，InfoPath 将取消窗体的打开。 如果 OnVersionUpgrade 事件的脚本编写代码中发生错误，InfoPath 将忽略它，并依赖于 对象的 ReturnStatus 属性 VersionUpgradeEventObject 。 如果没有显式设置 ReturnStatus 属性，则使用默认值 true。

注意：如果为表单模板的 OnVersionUpgrade 事件创建事件处理程序，则必须编辑表单定义文件 (.xsf) ，以包含 documentVersionUpgrade 元素的可选 useScriptHandler 元素，然后它才会运行。