_XDocumentEventSink2_Event.OnVersionUpgrade Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o número de versão de um formulário do Microsoft InfoPath que está sendo aberto é mais antigo do que o número de versão do modelo de formulário no qual ele se baseia.
public:
event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnVersionUpgradeEventHandler ^ OnVersionUpgrade;event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler OnVersionUpgrade;member this.OnVersionUpgrade : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnVersionUpgradeEventHandler Event OnVersionUpgrade As _XDocumentEventSink2_OnVersionUpgradeEventHandler Tipo de evento
Exemplos
No exemplo a seguir, as DocumentVersion propriedades e SolutionVersion do VersionUpgradeEventObject objeto são usadas para exibir os números de versão do formulário e do modelo de formulário:
[InfoPathEventHandler(EventType=InfoPathEventType.<span class="label">OnVersionUpgrade</span>)]
public void OnVersionUpgrade(VersionUpgradeEvent e)
{
thisXDocument.UI.Alert("The form version: " + e.DocumentVersion +
"\nThe form template version: " + e.SolutionVersion);
e.ReturnStatus = true;
}
No exemplo a seguir, as DocumentVersion propriedades e SolutionVersion do VersionUpgradeEventObject objeto são usadas para exibir os números de versão do formulário e do modelo de formulário:
[InfoPathEventHandler(EventType=InfoPathEventType.<span class="label">OnVersionUpgrade</span>)]
public void OnVersionUpgrade(VersionUpgradeEvent e)
{
thisXDocument.UI.Alert("The form version: " + e.DocumentVersion +
"\nThe form template version: " + e.SolutionVersion);
e.ReturnStatus = true;
}
Comentários
Esse manipulador de eventos permite que os usuários cancelem uma operação.
Durante o evento OnVersionUpgrade , o documento XML subjacente do formulário é colocado no modo somente leitura e não é validado no esquema XML associado do formulário. Se a ReturnStatus propriedade do VersionUpgradeEventObject objeto estiver definida como false, o InfoPath cancelará a abertura do formulário. Se ocorrer um erro no código de script para o evento OnVersionUpgrade , o InfoPath o ignorará e dependerá da propriedade ReturnStatus do VersionUpgradeEventObject objeto. Se a propriedade ReturnStatus não for definida explicitamente, o valor padrão do true será usado.
Observação: se você criar um manipulador de eventos para o evento OnVersionUpgrade de um modelo de formulário, deverá editar o arquivo de definição de formulário (.xsf) para incluir o elemento use opcionalScriptHandler do elemento documentVersionUpgrade antes de ser executado.