Evento FormEvents.VersionUpgrade

Articolo
04/27/2010

Si verifica quando il numero di versione di un modulo che sta per essere aperto è meno recente di quello del modello di modulo su cui è basato.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public Event VersionUpgrade As VersionUpgradeEventHandler

Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler

AddHandler instance.VersionUpgrade, handler

public abstract event VersionUpgradeEventHandler VersionUpgrade

Eccezioni

Tipo eccezione	Condizione
InvalidOperationException	Lo sviluppatore ha cercato di associare l'evento in una posizione diversa dal metodo InternalStartup.

Osservazioni

Importante:
Gli sviluppatori non devono creare un'istanza dell'evento VersionUpgrade nel codice del modulo. È consigliabile aggiungere gestori eventi per eventi a livello di modulo solo dall'interfaccia utente in modalità progettazione di Microsoft Office InfoPath 2007. Quando si aggiunge un gestore eventi al modello di modulo dall'interfaccia utente in modalità progettazione, tramite InfoPath viene generato codice nel metodo InternalStartup del file di codice del modulo utilizzando la classe EventManager e il membro della classe FormEvents per associare l'evento al relativo gestore eventi. Per informazioni su come aggiungere gestori eventi in modalità progettazione di InfoPath, vedere Procedura: Aggiungere un gestore eventi.

Gli sviluppatori non devono creare un'istanza dell'evento VersionUpgrade nel codice del modulo. È consigliabile aggiungere gestori eventi per eventi a livello di modulo solo dall'interfaccia utente in modalità progettazione di Microsoft Office InfoPath 2007. Quando si aggiunge un gestore eventi al modello di modulo dall'interfaccia utente in modalità progettazione, tramite InfoPath viene generato codice nel metodo InternalStartup del file di codice del modulo utilizzando la classe EventManager e il membro della classe FormEvents per associare l'evento al relativo gestore eventi. Per informazioni su come aggiungere gestori eventi in modalità progettazione di InfoPath, vedere Procedura: Aggiungere un gestore eventi.

Un gestore eventi per l'evento VersionUpgrade consente di eseguire codice per aggiornare un modulo quando il modello di modulo su cui questo è basato è stato aggiornato dopo l'ultima volta che il modulo è stato aperto.

L'evento VersionUpgrade viene associato utilizzando il delegato VersionUpgradeEventHandler.

L'evento VersionUpgrade può essere annullato utilizzando la proprietà CancelableArgs della classe VersionUpgradeEventArgs per impostare la proprietà Cancel su true.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007 o in un browser.

Esempio

Nell'esempio seguente vengono utilizzate le proprietà DocumentVersion e FormTemplateVersion della classe VersionUpgradeEventArgs per visualizzare i numeri di versione del modulo e del modello di modulo.

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

Vedere anche

Riferimenti

Classe FormEvents
Membri FormEvents
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite