FormEvents.VersionUpgrade, événement
Se produit lorsque le numéro de version du formulaire en cours d'ouverture est antérieur à celui du modèle de formulaire sur lequel il est basé.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Event VersionUpgrade As VersionUpgradeEventHandler
'Utilisation
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler
AddHandler instance.VersionUpgrade, handler
public abstract event VersionUpgradeEventHandler VersionUpgrade
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | Le développeur a tenté de lier l'événement dans un emplacement autre que la méthode InternalStartup. |
Remarques
Important
L'événement VersionUpgrade n'est pas destiné à être instancié par le développeur dans le code de formulaire. Vous ne devez ajouter des gestionnaires d'événements pour les événements au niveau du formulaire qu'à partir de l'interface utilisateur Microsoft InfoPath 2010 en mode Création. Lorsque vous ajoutez un gestionnaire d'événements à votre modèle de formulaire à partir de l'interface utilisateur en mode Création, InfoPath génère du code dans la méthode InternalStartup du fichier de code de votre formulaire à l'aide de la classe EventManager et du membre de la classe FormEvents pour lier l'événement à son gestionnaire d'événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure d'ajout d'un gestionnaire d'événements.
Un gestionnaire d'événements pour l'événement VersionUpgrade vous permet d'exécuter du code pour mettre à jour un formulaire lorsque le modèle de formulaire sur lequel il est basé a été mis à niveau depuis la dernière ouverture du formulaire.
L'événement VersionUpgrade est lié à l'aide du délégué VersionUpgradeEventHandler.
L'événement VersionUpgrade peut être annulé en utilisant la propriété CancelableArgs de la classe VersionUpgradeEventArgs pour affecter à la propriété Cancel la valeur true.
Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur Web.
Exemples
Dans l'exemple suivant, les propriétés DocumentVersion et FormTemplateVersion de la classe VersionUpgradeEventArgs sont utilisées pour afficher les numéros de version du formulaire et du modèle de formulaire :
public void FormEvents_VersionUpgrade(object sender, VersionUpgradeEventArgs e)
{
MessageBox.Show("The form version: " + e.DocumentVersion +
"\nThe form template version: " + e.FormTemplateVersion);
// Write code to update form here.
}
Public Sub FormEvents_VersionUpgrade(ByVal sender As Object, _
ByVal e As VersionUpgradeEventArgs)
MessageBox.Show("The form version: " & e.DocumentVersion & _
vbNewLine & "The form template version: " & _
e.FormTemplateVersion)
' Write code to update form here.
End Sub