FormEvents.VersionUpgrade Ereignis

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Tritt ein, wenn die Versionsnummer des Formulars, das geöffnet wird, älter ist als die Versionsnummer der Formularvorlage, auf der das Formular basiert.

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 

Ereignistyp

VersionUpgradeEventHandler

Ausnahmen

InvalidOperationException

Es wurde versucht, das Ereignis an einen anderen Speicherort als die InternalStartup-Methode zu binden.

Beispiele

Im folgenden Beispiel werden die DocumentVersion Eigenschaften und FormTemplateVersion der VersionUpgradeEventArgs -Klasse verwendet, um die Versionsnummern des Formulars und der Formularvorlage anzuzeigen.

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

Hinweise

Wichtig: Das VersionUpgrade-Ereignis soll nicht vom Entwickler im Formularcode instanziiert werden. Sie sollten nur Ereignishandler für Ereignisse auf Formularebene über die Benutzeroberfläche des Microsoft InfoPath-Entwurfsmodus hinzufügen. Wenn Sie ihrer Formularvorlage über die Benutzeroberfläche des Entwurfsmodus einen Ereignishandler hinzufügen, generiert InfoPath Code in der InternalStartup-Methode Ihrer Formularcodedatei mithilfe der EventManager -Klasse und des Members der FormEvents -Klasse, um das Ereignis an ihren 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.

Das VersionUpgrade-Ereignis wird mithilfe des VersionUpgradeEventHandler Delegaten gebunden.

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.