_XDocumentEventSink2_Event.OnVersionUpgrade - Événement

Article
05/11/2015

Survient lorsque le numéro de version d’un formulaire Microsoft InfoPath en cours d’ouverture est antérieur à celui du modèle de formulaire sur lequel il est basé.

Espace de noms : Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly : Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler
'Utilisation
Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnVersionUpgradeEventHandler

AddHandler instance.OnVersionUpgrade, handler

event _XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade

Remarques

Ce gestionnaire d’événements permet aux utilisateurs d’annuler une opération.

Pendant l’événement OnVersionUpgrade, le document XML sous-jacent du formulaire est mis en mode lecture seule et il n’est pas validé par rapport au schéma XML associé au formulaire. Si la propriété ReturnStatus de l’objet VersionUpgradeEventObject a la valeur false, InfoPath annule l’ouverture du formulaire. Si une erreur se produit dans le code de script de l’événement OnVersionUpgrade, InfoPath l’ignore et s’appuie sur la propriété ReturnStatus de l’objet VersionUpgradeEventObject. Si la propriété ReturnStatus n’est pas définie de manière explicite, la valeur par défaut true est utilisée.

Notes

Si vous créez un gestionnaire d’événements pour l’événement OnVersionUpgrade d’un modèle de formulaire, vous devez modifier le fichier de définition du formulaire (.xsf) pour inclure l’élément facultatif useScriptHandler de l’élément documentVersionUpgrade avant son exécution.

Exemples

Dans l’exemple suivant, les propriétés DocumentVersion et SolutionVersion de l’objet VersionUpgradeEventObject sont utilisées pour afficher les numéros de version du formulaire et du modèle de formulaire :

[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;
}

Voir aussi

Référence

_XDocumentEventSink2_Event interface

_XDocumentEventSink2_Event - Membres

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms

Share via