Поделиться через

_XDocumentEventSink2_Event.OnVersionUpgrade Событие

  • Ссылка

Определение

Пространство имен:
Microsoft.Office.Interop.InfoPath.SemiTrust
Сборка:
Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Происходит, когда номер версии открываемой формы Microsoft InfoPath старше номера версии шаблона формы, на котором она основана.

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

Тип события

_XDocumentEventSink2_OnVersionUpgradeEventHandler

Примеры

В следующем примере DocumentVersion свойства VersionUpgradeEventObject и SolutionVersion объекта используются для отображения номеров версий формы и шаблона формы:

[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;
}

В следующем примере DocumentVersion свойства VersionUpgradeEventObject и SolutionVersion объекта используются для отображения номеров версий формы и шаблона формы:

[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;
}

Комментарии

Этот обработчик события позволяет пользователям отменить операцию.

Во время события OnVersionUpgrade базовый документ XML формы становится доступен только для чтения, и не проверяется по схеме XML, связанной с формой. Если свойству ReturnStatusVersionUpgradeEventObject объекта присвоено значение false, InfoPath отменяет открытие формы. Если в коде скрипта для события OnVersionUpgrade возникает ошибка, InfoPath игнорирует ее и использует свойство VersionUpgradeEventObjectReturnStatus объекта . Если свойство ReturnStatus не задано явно, используется значение по умолчанию true.

Примечание. При создании обработчика событий для события OnVersionUpgrade шаблона формы необходимо изменить файл определения формы (XSF), чтобы включить необязательный элемент useScriptHandler элемента documentVersionUpgrade перед его выполнением.

Применяется к