Событие FormEvents.VersionUpgrade

Статья
04/27/2010

Создается, если номер версии открываемой формы старше номера версии шаблона формы, на котором она основана.

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

Синтаксис

'Декларация
Public Event VersionUpgrade As VersionUpgradeEventHandler
'Применение
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler

AddHandler instance.VersionUpgrade, handler

public abstract event VersionUpgradeEventHandler VersionUpgrade

Исключения

Тип исключения	Условие
InvalidOperationException	Попытка разработчика привязать событие в другом местоположении, чем метод InternalStartup.

Заметки

Внимание!
Создание разработчиком экземпляра события VersionUpgrade в коде формы не предполагается. Пользователь должен только добавить обработчики событий для событий уровня формы из пользовательского интерфейса режима конструктора Microsoft Office InfoPath 2007. При добавлении обработчика события к шаблону формы из пользовательского интерфейса режима конструктора InfoPath генерирует код в методе InternalStartup файла кода формы с помощью класса EventManager и члена класса FormEvents для привязки события к его обработчику. Сведения о порядке добавления обработчиков событий в режиме конструктора InfoPath см. в разделе Практическое руководство. Добавление обработчика событий.

Создание разработчиком экземпляра события VersionUpgrade в коде формы не предполагается. Пользователь должен только добавить обработчики событий для событий уровня формы из пользовательского интерфейса режима конструктора Microsoft Office InfoPath 2007. При добавлении обработчика события к шаблону формы из пользовательского интерфейса режима конструктора InfoPath генерирует код в методе InternalStartup файла кода формы с помощью класса EventManager и члена класса FormEvents для привязки события к его обработчику. Сведения о порядке добавления обработчиков событий в режиме конструктора InfoPath см. в разделе Практическое руководство. Добавление обработчика событий.

Обработчик события для события VersionUpgrade позволяет запустить код для обновления формы, если шаблон формы, на котором она основана, был обновлен со времени последнего открытия формы.

Событие VersionUpgrade привязано с помощью делегата VersionUpgradeEventHandler.

Событие VersionUpgrade можно отменить с помощью свойства CancelableArgs класса VersionUpgradeEventArgs, установив для свойства Cancel значение true.

Доступ к этому типу или члену имеется из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007 или в веб-обозревателе.

Пример

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

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

См. также

Ссылка

Класс FormEvents
Члены FormEvents
Пространство имен Microsoft.Office.InfoPath

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