Melhorar o desempenho de um suplemento VSTO

2025-06-12

Você pode oferecer aos usuários uma experiência melhor otimizando os Suplementos VSTO criados para aplicativos do Office para que eles iniciem, desliguem, abram itens e executem outras tarefas rapidamente. Se o suplemento VSTO for para Outlook, você também poderá reduzir a chance de que o suplemento VSTO seja desabilitado devido ao baixo desempenho. Você pode aumentar o desempenho do suplemento VSTO implementando as seguintes estratégias:

Carregue suplementos VSTO sob demanda.
Publique soluções do Office usando o Windows Installer.
Ignorar reflexão da Faixa de Opções.
Execute operações caras em um thread de execução separado.

Para obter mais informações sobre como otimizar um suplemento VSTO do Outlook, consulte Critérios de desempenho para manter os suplementos VSTO habilitados.

Carregar suplementos VSTO sob demanda

Você pode configurar um suplemento VSTO para carregar somente nas seguintes circunstâncias:

A primeira vez que o usuário inicia o aplicativo após a instalação do suplemento VSTO.
A primeira vez que o usuário interage com o suplemento VSTO depois de iniciar o aplicativo em qualquer momento subsequente.

Por exemplo, seu suplemento VSTO pode preencher uma planilha com dados quando o usuário escolhe um botão personalizado rotulado Obter Meus Dados. O aplicativo deve carregar o suplemento VSTO pelo menos uma vez para que o botão Obter Meus Dados possa aparecer na Faixa de Opções. No entanto, o suplemento VSTO não carrega novamente quando o usuário inicia o aplicativo na próxima vez. O suplemento VSTO é carregado somente quando o usuário escolhe o botão Obter Meus Dados .

Para configurar uma solução ClickOnce para carregar suplementos VSTO sob demanda

No Gerenciador de Soluções, escolha o nó do projeto.
Na barra de menus, escolha Exibir>Páginas de Propriedade.
Na guia Publicar, escolha o botão Opções.
Na caixa de diálogo Opções de Publicação, escolha o item de lista Configurações do Office, escolha a opção Carregar sob Demanda e escolha o botão OK.

Para configurar uma solução do Windows Installer para carregar suplementos VSTO sob demanda

No registro, defina a LoadBehaviorentrada da chave de ID Root\Software\Microsoft\Office\ApplicationName\Addins\Add-in como 0x10.

Para obter mais informações, consulte Entradas do Registro para suplementos VSTO.

Para configurar uma solução para carregar suplementos VSTO sob demanda enquanto você depura a solução

Crie um script que defina a LoadBehavior entrada da chave Root\Software\Microsoft\Office\ApplicationName\Addins\Add-in ID como 0x10.

O código a seguir mostra um exemplo desse script.

[HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\Addins\MyAddIn]
"Description"="MyAddIn"
"FriendlyName"="MyAddIn"
"LoadBehavior"=dword:00000010
"Manifest"="c:\\Temp\\MyAddIn\\bin\\Debug\\MyAddIn.vsto|vstolocal"

Crie um evento pós-compilação que atualize o Registro usando o script.

O código a seguir mostra um exemplo de uma cadeia de caracteres de comando que você pode adicionar a um evento pós-compilação.
```
regedit /s "$(SolutionDir)$(SolutionName).reg"
```
Para obter informações sobre como criar eventos pós-compilação em um projeto C#, consulte Como especificar eventos de compilação (C#).

Para obter informações sobre como criar um evento pós-compilação em um projeto Visual Basic, consulte Como: Especificar eventos de compilação (Visual Basic).

Publicar soluções do Office usando o Windows Installer

Se você publicar sua solução usando o Windows Installer, o Visual Studio 2010 Tools for Office runtime ignora as etapas a seguir quando o suplemento VSTO é carregado.

Validando o esquema de manifesto.
Verificação automática de atualizações.
Validando as assinaturas digitais dos manifestos de implantação.

Observação

Essa abordagem não será necessária se você implantar o suplemento VSTO em um local seguro nos computadores dos usuários.

Para obter mais informações, consulte Implantar uma solução do Office usando o Windows Installer.

Ignorar reflexão da Faixa de Opções

Se você criar uma solução usando o Visual Studio 2012, verifique se os usuários instalaram a versão mais recente do tempo de execução do Visual Studio 2010 Tools for Office ao implantar a solução. Versões mais antigas do tempo de execução do VSTO refletidas em assemblies de solução para localizar personalizações da Faixa de Opções. Esse processo pode fazer com que o suplemento VSTO seja carregado mais lentamente.

Como alternativa, você pode impedir que qualquer versão do tempo de execução do Visual Studio 2010 Tools for Office use a reflexão para identificar personalizações da Faixa de Opções. Para seguir essa estratégia, substitua o CreateRibbonExtensibility método e retorne explicitamente objetos da Faixa de Opções. Se o suplemento VSTO não contiver personalizações da Faixa de Opções, retorne null dentro do método.

O exemplo a seguir retorna um objeto Ribbon com base no valor de um campo.

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function

Executar operações caras em um thread de execução separado

Considere executar tarefas demoradas (como tarefas de longa execução, conexões de banco de dados ou outros tipos de chamadas de rede) em um thread separado. Para obter mais informações, consulte Suporte a threading no Office.

Observação

Todo o código que chama o modelo de objeto do Office deve ser executado no thread principal.

Compartilhar via