_XDocumentEventSink2_Event.OnVersionUpgrade Evento

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Se produce cuando el número de versión de un formulario de Microsoft InfoPath que se abre es anterior al número de versión de la plantilla de formulario en la que se basa.

public:
 event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnVersionUpgradeEventHandler ^ OnVersionUpgrade;

event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade;

member this.OnVersionUpgrade : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler 

Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler 

Tipo de evento

_XDocumentEventSink2_OnVersionUpgradeEventHandler

Ejemplos

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

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

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

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

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 ReturnStatus propiedad del VersionUpgradeEventObject objeto se establece en false, InfoPath cancela la apertura del formulario. Si se produce un error en el código de scripting para el evento OnVersionUpgrade , InfoPath lo omite y se basa en la propiedad ReturnStatus del VersionUpgradeEventObject objeto. Si la propiedad ReturnStatus no se ha establecido de manera explícita, se utilizará el valor predeterminado: true.

Nota: Si crea un controlador de eventos para el evento OnVersionUpgrade de una plantilla de formulario, debe editar el archivo de definición de formulario (.xsf) para incluir el elemento useScriptHandler opcional del elemento documentVersionUpgrade antes de que se ejecute.