FormEvents.VersionUpgrade Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
public:
abstract event Microsoft::Office::InfoPath::VersionUpgradeEventHandler ^ VersionUpgrade;public abstract event Microsoft.Office.InfoPath.VersionUpgradeEventHandler VersionUpgrade;member this.VersionUpgrade : Microsoft.Office.InfoPath.VersionUpgradeEventHandler Public MustOverride Custom Event VersionUpgrade As VersionUpgradeEventHandler Tipo de evento
Excepciones
El programador intentó enlazar el evento en una ubicación que no es el método InternalStartup.
Ejemplos
En el ejemplo siguiente, las DocumentVersion propiedades y FormTemplateVersion de la VersionUpgradeEventArgs clase se usan 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
Comentarios
Importante: El evento VersionUpgrade no está pensado para que el desarrollador cree una instancia en el código de formulario. Solo debe agregar controladores de eventos para eventos de nivel de formulario 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 del modo de diseño, InfoPath genera código en el método InternalStartup del archivo de código de formulario mediante la EventManager clase y el miembro de la FormEvents clase 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 mediante el VersionUpgradeEventHandler delegado.
El evento VersionUpgrade se puede cancelar mediante la CancelableArgs propiedad de la VersionUpgradeEventArgs clase 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.