_XDocumentEventSink2_Event.OnVersionUpgrade (Evento)

Ocurre cuando el número de versión del formulario de Microsoft Office InfoPath 2007 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

Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler

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.

Ejemplo

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

_XDocumentEventSink2_Event (Interfaz)
_XDocumentEventSink2_Event (Miembros)
Microsoft.Office.Interop.InfoPath.SemiTrust (Espacio de nombres)