Событие _XDocumentEventSink2_Event.OnVersionUpgrade

Статья
04/27/2010

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

Пространство имен: Microsoft.Office.Interop.InfoPath.SemiTrust
Сборка: Microsoft.Office.Interop.InfoPath.SemiTrust (в microsoft.office.interop.infopath.semitrust.dll)

Синтаксис

'Декларация
Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler
'Применение
Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnVersionUpgradeEventHandler

AddHandler instance.OnVersionUpgrade, handler

event _XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade

Заметки

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

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

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

Пример

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

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

См. также

Ссылка

Интерфейс _XDocumentEventSink2_Event
Члены _XDocumentEventSink2_Event
Пространство имен Microsoft.Office.Interop.InfoPath.SemiTrust

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