Compartilhar via

Visão geral do ambiente de tempo de execução das Ferramentas do Visual Studio para Office

Para executar soluções criadas usando as ferramentas de desenvolvedor do Microsoft Office no Visual Studio, o runtime do Visual Studio 2010 Tools for Office deve ser instalado em computadores de usuário final. Para obter mais informações, consulte Como instalar as Ferramentas do Visual Studio para o runtime do Office redistribuíveis. O runtime das Ferramentas do Visual Studio 2010 para Office consiste em dois componentes principais:

Entender as extensões do Office para o .NET Framework

O runtime do Visual Studio 2010 Tools for Office inclui extensões do Office para o .NET Framework 3.5, o .NET Framework 4 e posteriores. As soluções direcionadas a cada versão do .NET Framework usam as extensões apropriadas para essa versão.

Essas extensões consistem em assemblies que suas soluções usam para automatizar e estender aplicativos do Office. Quando você cria um projeto do Office, o Visual Studio adiciona automaticamente referências aos assemblies que são usados para o tipo de projeto e o .NET Framework de destino do projeto. Para obter mais informações sobre os assemblies nas extensões do Office, consulte Assemblies no runtime das Ferramentas do Visual Studio para Office.

Diferenças de design nas extensões do Office

A maioria dos tipos que você usa nas extensões do Office para o .NET Framework 3.5 são classes. Essas são as mesmas classes que foram incluídas em versões anteriores das Ferramentas do Visual Studio para o runtime do Office. Por outro lado, a maioria dos tipos que você usa nas extensões do Office para o .NET Framework 4 ou posterior são interfaces. Por exemplo, quando você direciona o .NET Framework 4 ou posterior, os tipos Worksheet e Document são interfaces em vez de classes.

Na maioria dos casos, o código que você escreve em soluções do Office é o mesmo se sua solução tem como destino o .NET Framework 3.5 ou o .NET Framework 4. No entanto, determinados recursos exigem código diferente quando você mira diferentes versões do .NET Framework. Para obter mais informações, consulte Migrar soluções do Office para o .NET Framework 4 ou posterior.

Interfaces nas extensões do Office para o .NET Framework 4 ou posterior

A maioria das interfaces nas extensões do Office para o .NET Framework 4 ou posterior não se destina a ser implementada pelo código do usuário. As únicas interfaces que você pode implementar diretamente têm nomes que começam com a letra I, como ISmartTagExtension.

Todas as interfaces que não começam com a letra eu são implementadas internamente pelas Ferramentas do Visual Studio 2010 para o runtime do Office e essas interfaces podem mudar em versões futuras. Para criar objetos que implementam essas interfaces, use métodos fornecidos pelo Globals.Factory objeto em seu projeto. Por exemplo, para obter um objeto que implementa a SmartTag interface, use o Globals.Factory.CreateSmartTag método. Para obter mais informações sobre Globals.Factory, consulte o acesso global a objetos em projetos do Office.

Habilitar equivalência de tipos e tipos incorporados em projetos que visam o .NET Framework 4 ou posterior

Como o modelo de objeto das extensões do Office para o .NET Framework 4 ou posterior é baseado em interfaces, você pode usar o recurso de equivalência de tipo no Visual C# e no Visual Basic no Visual Studio para inserir informações de tipo do runtime das Ferramentas do Visual Studio para Office em sua solução. Esse recurso permite que as soluções do Office e o runtime das Ferramentas do Visual Studio para Office possam ser versionados independentemente uma da outra. Por exemplo, se sua solução usar a interface Document como um tipo embutido e a próxima versão do runtime adicionar membros à interface Document, sua solução ainda será compatível com a próxima versão do runtime. Se sua solução não usar a Document interface como um tipo inserido, sua solução não funcionará mais com a próxima versão do runtime.

Por padrão, o recurso de equivalência de tipo não é habilitado quando você cria um projeto do Office direcionado ao .NET Framework 4 ou posterior. Se você quiser habilitar esse recurso, defina a propriedade Inserir Tipos de Interoperabilidade de qualquer uma das seguintes referências de assembly em seu projeto como True:

  • Microsoft.Office.Tools.dll

  • Microsoft.Office.Tools.Common.dll

  • Microsoft.Office.Tools.Excel.dll

  • Microsoft.Office.Tools.Outlook.dll

  • Microsoft.Office.Tools.Word.dll

    Depois de fazer essa alteração, as informações de tipo para todos os tipos de runtime usados pelo projeto são inseridas no assembly da solução quando você cria o projeto. Essas informações de tipo incorporado, ao invés das informações de tipo nos assemblies referenciados, são utilizadas pela solução em tempo de execução.

Entender o carregador de solução do Office

O tempo de execução das Ferramentas do Visual Studio para Office inclui várias DLLs não gerenciadas, que são usadas pelos aplicativos do Office para carregar o tempo de execução e as soluções do Office. Embora você nunca precise trabalhar diretamente com essas DLLs, conhecer as finalidades dessas DLLs pode ajudá-lo a entender melhor a arquitetura das soluções do Office.

Para obter informações sobre como esses componentes são usados durante o processo de carga, consulte Arquitetura de personalizações no nível do documento e arquitetura de suplementos VSTO.

VSTOEE.dll

Quando um usuário abre uma personalização no nível do documento ou inicia um Suplemento VSTO, o aplicativo do Office chama VSTOEE.dll para executar as tarefas necessárias para carregar o Visual Studio Tools for Office runtime.

VSTOEE.dll garante que a versão correta do runtime das Ferramentas do Visual Studio para Office seja carregada para a solução e a versão instalada do Office. Embora várias versões do runtime do Visual Studio Tools for Office possam ser instaladas no mesmo computador, apenas uma instância de VSTOEE.dll é instalada por vez. Este é o VSTOEE.dll que foi incluído com a versão mais recente do runtime instalada no computador. Para obter mais informações sobre as diferentes versões do runtime das Ferramentas do Visual Studio para Office que podem ser usadas para outras soluções, consulte Executar soluções em diferentes versões do Microsoft Office.

VSTOLoader.dll

Depois que VSTOEE.dll carrega a versão apropriada das Ferramentas do Visual Studio para o runtime do Office, VSTOLoader.dll executa a maior parte do trabalho necessário para carregar o assembly da solução. VSTOLoader.dll faz várias coisas:

  • Ele cria um domínio de aplicação para cada assembly de solução.

  • Ele executa um conjunto de verificações de segurança para verificar se o assembly da solução tem permissão para ser executado.

  • Ele carrega a versão das extensões do Office para o .NET Framework que é exigida pela solução.

    VSTOLoader.dll também faz várias coisas específicas para suplementos VSTO:

  • Ele implementa a IDTExtensibility2 interface. IDTExtensibility2 é uma interface COM que todos os add-ins VSTO para aplicativos do Microsoft Office devem implementar. Essa interface define métodos que o aplicativo chama para se comunicar com o Suplemento VSTO.

  • Ele implementa a interface IManagedAddin. Essa interface é usada por aplicativos do Office para ajudar a carregar complementos do VSTO. Para obter mais informações, consulte a interface IManagedAddin.

Entender as versões de 32 bits e 64 bits do runtime

Há versões separadas de 64 bits e 32 bits do runtime do Visual Studio 2010 Tools for Office. Essas versões do runtime são usadas para executar soluções em edições de 64 bits e 32 bits do Office. A tabela a seguir mostra qual versão do runtime é necessária para cada combinação do Windows e do Office.

Edição do Windows Edição do Microsoft Office Versão necessária do runtime do Visual Studio Tools for Office
32-bit 32-bit 32-bit
64-bit 32-bit 64-bit
64-bit 64-bit 64-bit

Quando você instala o Office, a versão necessária do runtime das Ferramentas do Visual Studio para Office é instalada junto com o Office. Por exemplo, quando você instala a edição de 64 bits do Office em uma versão de 64 bits do Windows, a versão de 64 bits do runtime das Ferramentas do Visual Studio para Office também é instalada. Para obter mais informações sobre como instalar o runtime das Ferramentas do Visual Studio para Office com o Office, consulte os cenários de instalação das Ferramentas do Visual Studio para Office.

A versão de 64 bits do Office também pode executar soluções do Office que foram criadas usando modelos de projeto para o sistema do Microsoft Office 2007 no Visual Studio 2008. No entanto, ele não pode executar soluções do Office criadas usando modelos de projeto para o Microsoft Office 2003 no Visual Studio 2008 ou soluções do Office criadas usando o Visual Studio 2005. Para obter mais informações, consulte Executar soluções em diferentes versões do Microsoft Office.

Reparar as Ferramentas do Visual Studio 2010 para o runtime do Office

Se você precisar reparar o runtime, abrir Programas e Recursos ou Adicionar ou Remover Programas no Painel de Controle, selecione As Ferramentas do Microsoft Visual Studio 2010 para Office Runtime na lista de programas e clique em Desinstalar. O programa de instalação executado permite que você repare o runtime. Se você clicar em Alterar, não será dada uma opção para reparar o runtime.

Conteúdo relacionado

  • Last updated on