_XDocumentEventSink2_Event.OnVersionUpgrade Événement

Définition

Se produit lorsque le numéro de version d’un formulaire Microsoft InfoPath ouvert est antérieur au numéro de version du modèle de formulaire sur lequel il est basé.

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 

Type d'événement

Exemples

Dans l’exemple suivant, les DocumentVersion propriétés 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.<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;
}

Dans l’exemple suivant, les DocumentVersion propriétés 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.<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;
}

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 ReturnStatus propriété de l’objet VersionUpgradeEventObject est définie sur 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.

Remarque : 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 de formulaire (.xsf) pour inclure l’élément useScriptHandler facultatif de l’élément documentVersionUpgrade avant son exécution.

S’applique à