Evento FormEvents.VersionUpgrade
Ocurre cuando el número de versión del formulario que se ha abierto es más antiguo que el número de versión de la plantilla de formulario en que se basa.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Event VersionUpgrade As VersionUpgradeEventHandler
'Uso
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler
AddHandler instance.VersionUpgrade, handler
public abstract event VersionUpgradeEventHandler VersionUpgrade
Excepciones
| Excepción | Condición |
|---|---|
| InvalidOperationException | El programador intentó enlazar el evento en una ubicación que no es el método InternalStartup. |
Comentarios
Importante
El programador no debe crear instancias del evento VersionUpgrade en el código de formulario. Sólo debe agregar controladores de eventos para eventos del documento desde la interfaz de usuario del modo de diseño de Microsoft InfoPath. Al agregar un controlador de eventos a la plantilla de formulario desde la interfaz de usuario de modo de diseño, InfoPath genera código en el método InternalStartup del archivo de código de formulario mediante la clase EventManager y el miembro de la clase FormEvents para enlazar el evento a su controlador de eventos. Para obtener información sobre cómo agregar controladores de eventos en el modo de diseño de InfoPath, vea Cómo agregar un controlador de eventos.
Un controlador de eventos para el evento VersionUpgrade le permite ejecutar código para actualizar un formulario si la plantilla de formulario en que se basa se ha actualizado desde la última vez que se abrió.
El evento VersionUpgrade se enlaza utilizando el delegado VersionUpgradeEventHandler.
El evento VersionUpgrade se puede cancelar utilizando la propiedad CancelableArgs de la clase VersionUpgradeEventArgs para establecer la propiedad Cancel en true.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.
Ejemplos
En el siguiente ejemplo, las propiedades DocumentVersion y FormTemplateVersion de la clase VersionUpgradeEventArgs se utilizan para mostrar los números de versión del formulario y la plantilla de formulario.
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