FormEvents.VersionUpgrade Событие

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

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

public:
 abstract event Microsoft::Office::InfoPath::VersionUpgradeEventHandler ^ VersionUpgrade;

public abstract event Microsoft.Office.InfoPath.VersionUpgradeEventHandler VersionUpgrade;

member this.VersionUpgrade : Microsoft.Office.InfoPath.VersionUpgradeEventHandler 

Public MustOverride Custom Event VersionUpgrade As VersionUpgradeEventHandler 

Тип события

VersionUpgradeEventHandler

Исключения

InvalidOperationException

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

Примеры

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

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

Комментарии

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

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

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

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

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.