FormEvents.VersionUpgrade-Ereignis

Artikel
04/27/2010

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 Event VersionUpgrade As VersionUpgradeEventHandler
'Usage
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler

AddHandler instance.VersionUpgrade, handler

public abstract event VersionUpgradeEventHandler VersionUpgrade

Ausnahmen

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

Hinweise

Wichtig

Das VersionUpgrade-Ereignis sollte nicht im Formularcode instanziiert werden. Ereignishandler sollten Ereignissen auf Formularebene nur von der Microsoft Office InfoPath 2007-Entwurfsmodus-Benutzeroberfläche aus hinzugefügt werden. Wenn Sie der Formularvorlage von der Entwurfsmodus-Benutzeroberfläche aus einen Ereignishandler hinzufügen, wird in InfoPath mithilfe der EventManager-Klasse und mithilfe 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 diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

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

Siehe auch

Referenz

FormEvents-Klasse
FormEvents-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über