Evento _XDocumentEventSink2_Event.OnVersionUpgrade

Generato quando il numero di versione di un modulo di Microsoft Office InfoPath 2007 da aprire è meno recente di quello del modello di modulo su cui è basato.

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

Sintassi

Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler

Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnVersionUpgradeEventHandler

AddHandler instance.OnVersionUpgrade, handler

event _XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade

Osservazioni

Questo gestore eventi consente di annullare un'operazione.

Durante l'evento OnVersionUpgrade, viene attivata la modalità di sola lettura per il documento XML sottostante del modulo, che non viene convalidato in base allo schema XML associato al modulo. Se la proprietà ReturnStatus dell'oggetto VersionUpgradeEventObject è impostata su false, l'apertura del modulo viene annullata. Se si verifica un errore nel codice di script dell'evento OnVersionUpgrade, l'errore viene ignorato e viene utilizzata la proprietà ReturnStatus dell'oggetto VersionUpgradeEventObject. Se la proprietà ReturnStatus non è impostata in modo esplicito, viene utilizzato il valore predefinito true.

Nota:
Se si crea un gestore per l'evento OnVersionUpgrade di un modello di modulo, è necessario modificare il file di definizione del modulo (xsf) per includere l'elemento facoltativo useScriptHandler dell'elemento documentVersionUpgrade per consentire l'esecuzione.

Esempio

Nell'esempio seguente, le proprietà DocumentVersion e SolutionVersion dell'oggetto VersionUpgradeEventObject vengono utilizzate per visualizzare i numeri di versione del modulo e del modello di modulo:

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

Vedere anche

Riferimenti

Interfaccia _XDocumentEventSink2_Event
Membri _XDocumentEventSink2_Event
Spazio dei nomi Microsoft.Office.Interop.InfoPath.SemiTrust