Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

_XDocumentEventSink2_Event.OnVersionUpgrade - Événement

Office 2013 et versions ultérieures

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)

event _XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade

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.

RemarqueRemarque

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.

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;
}
Afficher: