FormEvents.VersionUpgrade Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é.
public:
abstract event Microsoft::Office::InfoPath::VersionUpgradeEventHandler ^ VersionUpgrade;public abstract event Microsoft.Office.InfoPath.VersionUpgradeEventHandler VersionUpgrade;member this.VersionUpgrade : Microsoft.Office.InfoPath.VersionUpgradeEventHandler Public MustOverride Custom Event VersionUpgrade As VersionUpgradeEventHandler Type d'événement
Exceptions
Le développeur a tenté de lier l'événement dans un emplacement autre que la méthode InternalStartup.
Exemples
Dans l’exemple suivant, les DocumentVersion propriétés et FormTemplateVersion de la VersionUpgradeEventArgs classe 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
Remarques
Important : l’événement VersionUpgrade n’est pas destiné à être instancié par le développeur dans le code de formulaire. Vous devez uniquement ajouter des gestionnaires d’événements pour les événements au niveau du formulaire à partir de l’interface utilisateur du mode création Microsoft InfoPath. 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 de votre fichier de code de formulaire à l’aide de la EventManager classe et du membre de la FormEvents classe 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 : Ajouter 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 VersionUpgradeEventHandler délégué.
L’événement VersionUpgrade peut être annulé à l’aide de la CancelableArgs propriété de la VersionUpgradeEventArgs classe pour définir la propriété Cancel sur true.
Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.