_XDocumentEventSink2_Event.OnVersionUpgrade 事件
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
当打开的 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 事件类型
示例
在以下示例中， 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 元素，然后它才会运行。