FormEvents.VersionUpgrade-Ereignis
Tritt ein, wenn die Versionsnummer des Formulars, das geöffnet wird, älter ist als die Versionsnummer der Formularvorlage, auf der das Formular basiert.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Event VersionUpgrade As VersionUpgradeEventHandler
'Usage
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler
AddHandler instance.VersionUpgrade, handler
public abstract event VersionUpgradeEventHandler VersionUpgrade
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Es wurde versucht, das Ereignis an einen anderen Speicherort als die InternalStartup-Methode zu binden. |
Hinweise
Wichtig
Das VersionUpgrade-Ereignis sollte nicht vom Entwickler im Formularcode instanziiert werden. Ereignishandler für Ereignisse auf Formularebene sollten nur über die Microsoft InfoPath-Entwurfsmodus-Benutzeroberfläche hinzugefügt werden. Wenn Sie der Formularvorlage über die Entwurfsmodus-Benutzeroberfläche einen Ereignishandler hinzufügen, wird in InfoPath mithilfe der EventManager-Klasse und des Members der FormEvents-Klasse in der InternalStartup-Methode der Formularcodedatei Code generiert, um das Ereignis an den zugehörigen Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.
Ein Ereignishandler für das VersionUpgrade-Ereignis ermöglicht das Ausführen von Code zum Aktualisieren eines Formulars, wenn die Formularvorlage, auf der das Formular basiert, aktualisiert wurde, seitdem das Formular das letzte Mal geöffnet wurde.
Die Bindung des VersionUpgrade-Ereignisses erfolgt mithilfe des VersionUpgradeEventHandler-Delegaten.
Das VersionUpgrade-Ereignis kann mithilfe der CancelableArgs-Eigenschaft der VersionUpgradeEventArgs-Klasse abgebrochen werden, um die Cancel-Eigenschaft auf true festzulegen.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel werden mithilfe der DocumentVersion- und FormTemplateVersion-Eigenschaften der VersionUpgradeEventArgs-Klasse die Versionsnummern des Formulars und der Formularvorlage angezeigt.
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