_XDocumentEventSink2_Event.OnVersionUpgrade Ereignis

Definition

Namespace:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Tritt auf, wenn die Versionsnummer eines geöffneten Microsoft InfoPath-Formulars älter ist als die Versionsnummer der Formularvorlage, auf der es basiert.

public:
 event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnVersionUpgradeEventHandler ^ OnVersionUpgrade;

event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade;

member this.OnVersionUpgrade : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler 

Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler 

Ereignistyp

_XDocumentEventSink2_OnVersionUpgradeEventHandler

Beispiele

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

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

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

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

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 im Skriptcode für das OnVersionUpgrade-Ereignis ein Fehler auftritt, ignoriert InfoPath diesen und basiert auf der 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, um das optionale useScriptHandler-Element des documentVersionUpgrade-Elements einzuschließen, bevor sie ausgeführt wird.