Compartir a través de

Evento _XDocumentEventSink2_Event.OnVersionUpgrade

  • Artículo

Ocurre cuando el número de versión del formulario de Microsoft InfoPath 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.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler
'Uso
Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnVersionUpgradeEventHandler

AddHandler instance.OnVersionUpgrade, handler

event _XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade

Comentarios

Este controlador de eventos permite al usuario cancelar una operación.

Durante el evento OnVersionUpgrade, el documento XML subyacente del formulario se pone en modo de sólo lectura y no se valida con respecto al Esquema XML asociado al formulario. Si la propiedad ReturnStatus del objeto VersionUpgradeEventObject está establecida en false, InfoPath cancelará la apertura del formulario. Si tiene lugar un error en el código de secuencias de comandos del evento OnVersionUpgrade, InfoPath hará caso omiso de él y utilizará la propiedad ReturnStatus del objeto VersionUpgradeEventObject. Si la propiedad ReturnStatus no se ha establecido de manera explícita, se utilizará el valor predeterminado: true.

Nota

Si se crea un controlador de eventos para el evento OnVersionUpgrade de una plantilla de formularios, se deberá editar el archivo de definición de formulario (.xsf) para incluir el elemento opcional useScriptHandler del elemento documentVersionUpgrade antes de que se pueda ejecutar.

Ejemplos

En el siguiente ejemplo, las propiedades DocumentVersion y SolutionVersion del objeto VersionUpgradeEventObject se utilizan para mostrar los números de versión del formulario y la plantilla de formulario:

[InfoPathEventHandler(EventType=InfoPathEventType.OnVersionUpgrade)]
public void OnVersionUpgrade(VersionUpgradeEvent e)
{
 thisXDocument.UI.Alert("The form version: " + e.DocumentVersion + 
  "\nThe form template version: " + e.SolutionVersion);
 e.ReturnStatus = true;
}

Vea también

Referencia

interfaz _XDocumentEventSink2_Event

Miembros _XDocumentEventSink2_Event

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust