FormEvents.VersionUpgrade 事件
在当前打开的表单的版本号小于该表单所基于的表单模板的版本号时发生。
命名空间: Microsoft.Office.InfoPath
程序集: Microsoft.Office.InfoPath(位于 Microsoft.Office.InfoPath.dll 中)
语法
声明
Public MustOverride Event VersionUpgrade As VersionUpgradeEventHandler
用法
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler
AddHandler instance.VersionUpgrade, handler
public abstract event VersionUpgradeEventHandler VersionUpgrade
异常
异常 | 条件 |
---|---|
InvalidOperationException | 开发人员尝试绑定 InternalStartup 方法以外的某个位置的事件。 |
备注
重要
不需要开发人员在表单代码中实例化 VersionUpgrade 事件。您只需从 Microsoft InfoPath 设计模式用户界面中为表单级事件添加事件处理程序。在您从设计模式用户界面向表单模板中添加事件处理程序时,InfoPath 会使用 EventManager 类和 FormEvents 类的成员在表单代码文件的 InternalStartup 方法中生成代码,以便将事件绑定到其事件处理程序。有关如何在 InfoPath 设计模式下添加事件处理程序的信息,请参阅如何:添加事件处理程序。
VersionUpgrade 事件的事件处理程序使您可以在自从上次打开表单后升级了该表单所基于的表单模板时,运行代码以更新该表单。
VersionUpgrade 事件是通过使用 VersionUpgradeEventHandler 委托绑定的。
使用 VersionUpgradeEventArgs 类的 CancelableArgs 属性将 Cancel 属性设置为 true,可取消 VersionUpgrade 事件。
可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。
示例
在以下示例中,VersionUpgradeEventArgs 类的 DocumentVersion 和 FormTemplateVersion 属性用于显示表单和表单模板的版本号。
public void FormEvents_VersionUpgrade(object sender, VersionUpgradeEventArgs e)
{
MessageBox.Show("The form version: " + e.DocumentVersion +
"\nThe form template version: " + e.FormTemplateVersion);
// Write code to update form here.
}
Public Sub FormEvents_VersionUpgrade(ByVal sender As Object, _
ByVal e As VersionUpgradeEventArgs)
MessageBox.Show("The form version: " & e.DocumentVersion & _
vbNewLine & "The form template version: " & _
e.FormTemplateVersion)
' Write code to update form here.
End Sub