_XDocumentEventSink2_Event.OnVersionUpgrade-Ereignis

Artikel
04/27/2010

Tritt ein, wenn die Versionsnummer eines Microsoft Office InfoPath 2007-Formulars, das geöffnet wird, älter ist als die Versionsnummer der Formularvorlage, auf der es basiert.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler

Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnVersionUpgradeEventHandler

AddHandler instance.OnVersionUpgrade, handler

event _XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade

Hinweise

Dieser Ereignishandler lässt es zu, dass Benutzer einen Vorgang abbrechen.

Während des OnVersionUpgrade-Ereignisses wird das dem Formular zugrunde liegende XML-Dokument in den Schreibschutzmodus versetzt und nicht anhand des dem Formular zugeordneten XML-Schemas überprüft. Wenn die ReturnStatus-Eigenschaft des VersionUpgradeEventObject-Objekts auf false festgelegt ist, bricht InfoPath das Öffnen des Formulars ab. Wenn ein Fehler im Skriptcode für das OnVersionUpgrade-Ereignis auftritt, ignoriert InfoPath den Fehler und stützt sich auf die ReturnStatus-Eigenschaft des VersionUpgradeEventObject-Objekts. Wenn die ReturnStatus-Eigenschaft nicht explizit festgelegt wurde, wird der Standardwert true verwendet.

Hinweis:
Wenn Sie einen Ereignishandler für das OnVersionUpgrade-Ereignis einer Formularvorlage erstellen, müssen Sie die Formulardefinitionsdatei (XSF) bearbeiten und das optionale useScriptHandler-Element des documentVersionUpgrade-Elements vor der Ausführung hinzufügen.

Beispiel

Im folgenden Beispiel werden die Eigenschaften DocumentVersion und SolutionVersion des VersionUpgradeEventObject-Objekts verwendet, um die Versionsnummern des Formulars und der Formularvorlage anzuzeigen:

[InfoPathEventHandler(EventType=InfoPathEventType.OnVersionUpgrade)]
public void OnVersionUpgrade(VersionUpgradeEvent e)
{
 thisXDocument.UI.Alert("The form version: " + e.DocumentVersion + 
  "\nThe form template version: " + e.SolutionVersion);
 e.ReturnStatus = true;
}

Siehe auch

Referenz

_XDocumentEventSink2_Event-Schnittstelle
_XDocumentEventSink2_Event-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über