FormEvents.VersionUpgrade Evento

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Ocorre quando o número de versão do formulário que está sendo aberto é mais antigo que o número de versão do modelo de formulário no qual ele se baseia.

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 

Tipo de evento

VersionUpgradeEventHandler

Exceções

InvalidOperationException

O desenvolvedor tentou associar o evento em algum local diferente do método InternalStartup .

Exemplos

No exemplo a seguir, as DocumentVersion propriedades e FormTemplateVersion da VersionUpgradeEventArgs classe são usadas para exibir os números de versão do formulário e do modelo de formulário.

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

Comentários

Importante: o evento VersionUpgrade não deve ser instanciado pelo desenvolvedor no código de formulário. Você só deve adicionar manipuladores de eventos para eventos no nível do formulário na interface do usuário do modo de design do Microsoft InfoPath. Quando você adiciona um manipulador de eventos ao modelo de formulário da interface do usuário do modo de design, o InfoPath gera código no método InternalStartup do arquivo de código de formulário usando a EventManager classe e o FormEvents membro da classe para associar o evento ao manipulador de eventos. Para obter informações sobre como adicionar manipuladores de eventos no modo de design do InfoPath, consulte Como adicionar um manipulador de eventos.

Um manipulador de eventos para o evento VersionUpgrade permite que você execute o código para atualizar um formulário quando o modelo de formulário no qual ele se baseia foi atualizado desde que o formulário foi aberto pela última vez.

O evento VersionUpgrade está vinculado usando o VersionUpgradeEventHandler delegado.

O evento VersionUpgrade pode ser cancelado usando a CancelableArgs propriedade da VersionUpgradeEventArgs classe para definir a propriedade Cancel como true.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.