FormEvents.VersionUpgrade (Evento)

  • Artículo

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

Public Event VersionUpgrade As VersionUpgradeEventHandler

Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler

AddHandler instance.VersionUpgrade, handler

public abstract event VersionUpgradeEventHandler VersionUpgrade

Excepciones

Tipo de 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 Office InfoPath 2007. 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 tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

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

Vea también

Referencia

FormEvents (Clase)
FormEvents (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)