Visão geral do Ferramentas do Visual Studio para Office Runtime

Para executar soluções criadas usando o Microsoft Office ferramentas de desenvolvedor no Visual Studio, o tempo de execução das ferramentas do Visual Studio 2010 para Office deve ser instalado nos computadores dos usuários finais. Para obter mais informações, consulte como instalar o ferramentas do Visual Studio para o Office Runtime Redistributable. O tempo de execução das ferramentas do Visual Studio 2010 para Office consiste em dois componentes principais:

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

O tempo de execução das ferramentas do Visual Studio 2010 para Office inclui extensões do Office para o .NET Framework 3,5, o .NET Framework 4 e posterior. As soluções que se destinam a cada versão do .NET Framework usam as extensões apropriadas para a versão em questão.

Essas extensões consistem em assemblies que suas soluções usam para automatizar e estender os aplicativos do Office. Quando você cria um projeto do Office, o Visual Studio adiciona automaticamente as 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 ferramentas do Visual Studio para o tempo de execução do Office.

Diferenças de design nas extensões do Office

A maioria dos tipos usados por você nas extensões do Office para o .NET Framework 3.5 é de classes. Essas são as mesmas classes que foram incluídas nas versões anteriores do Visual Studio Tools para Office Runtime. 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 Worksheet Document tipos e são interfaces em vez de classes.

Na maioria dos casos, o código que você escreve em soluções do Office será igual, mesmo se sua solução se destinar ao .NET Framework 3.5 ou ao .NET Framework 4. No entanto, alguns recursos exigem um código diferente quando você tem como destino versões diferentes 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 I são implementadas internamente pelo tempo de execução das ferramentas do Visual Studio 2010 para Office e essas interfaces podem ser alteradas em versões futuras. Para criar objetos que implementam essas interfaces, use os métodos fornecidos pelo objeto Globals.Factory no seu projeto. Por exemplo, para obter um objeto que implemente a interface SmartTag, use o método Globals.Factory.CreateSmartTag. Para obter mais informações sobre o Globals.Factory , consulte acesso global a objetos em projetos do Office.

Habilitar equivalência de tipo e tipos inseridos em projetos direcionados para 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 equivalência de tipo no Visual C# e Visual Basic no Visual Studio para inserir informações de tipo do Visual Studio Tools para Office Runtime em sua solução. Esse recurso permite que as soluções do Office e o Visual Studio Tools para Office Runtime sejam distribuídos em versões independentes umas das outras. Por exemplo, se sua solução usar a interface Document como um tipo inserido e a próxima versão de runtime adicionar membros à interface Document, sua solução ainda funcionará com a próxima versão de 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 tempo de execução.

Por padrão, o recurso de equivalência de tipo não é habilitado quando você cria um projeto do Office direcionado para o .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ê compila o projeto. As informações de tipo inseridas, em vez das informações de tipo em assemblies referenciados, são usadas pela solução em tempo de execução.

Entender o carregador de solução do Office

O Visual Studio Tools for Office Runtime inclui várias DLLs não gerenciadas que os aplicativos do Office usam para carregar o tempo de execução e as soluções do Office. Embora você nunca deva ter que trabalhar com essas DLL diretamente, saber as finalidades delas podem ajudar a compreender melhor a arquitetura das soluções do Office.

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

VSTOEE.dll

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

VSTOEE.dll verifica se a versão correta do Visual Studio Tools para Office Runtime está carregada para a solução e a versão instalada do Office. Embora várias versões do Visual Studio Tools para Office Runtime possam ser instaladas no mesmo computador, apenas uma instância do VSTOEE.dll é instalada de cada vez. Este é o VSTOEE.dll que foi incluído com a versão mais recente do tempo de execução instalado no computador. Para obter mais informações sobre as diferentes versões do Visual Studio Tools para Office Runtime que podem ser usadas para outras soluções, consulte executar soluções em versões diferentes do Microsoft Office.

VSTOLoader.dll

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

  • Cria um domínio de aplicativo para cada assembly da solução.

  • Executa um conjunto de verificações de segurança para verificar se o assembly da solução tem permissão para executar.

  • 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 os suplementos do VSTO:

  • Implementa a interface IDTExtensibility2. IDTExtensibility2 é uma interface COM que todos os suplementos do VSTO para aplicativos Microsoft Office devem implementar. Essa interface define os métodos que o aplicativo chama para se comunicar com o suplemento do VSTO.

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

Entender as versões de 32 bits e 64 bits do tempo de execução

Há versões separadas de 64 bits e 32 bits do tempo de execução das ferramentas do Visual Studio 2010 para Office. Essas versões do Runtime são usadas para executar soluções em edições de 64 bits e de 32 bits do Office. A tabela a seguir mostra qual versão do tempo de execução é 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 Visual Studio Tools for Office Runtime
32 bits 32 bits 32 bits
64 bits 32 bits 64 bits
64 bits 64 bits 64 bits

Quando você instala o Office, a versão necessária do Visual Studio Tools para Office Runtime é 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 Visual Studio Tools para Office Runtime também é instalada. Para obter mais informações sobre como instalar o Visual Studio Tools para Office Runtime com o Office, consulte Ferramentas do Visual Studio para cenários de instalação de tempo de execução do 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 de Microsoft Office de 2007 no Visual Studio 2008. No entanto, ela não pode executar soluções do Office criadas com modelos de projeto do Microsoft Office 2003 no Visual Studio 2008 nem soluções do Office criadas com o Visual Studio 2005. Para obter mais informações, consulte executar soluções em versões diferentes do Microsoft Office.

Reparar o tempo de execução das ferramentas do Visual Studio 2010 para Office

Se você precisar reparar o tempo de execução, abra programas e recursos ou adicione ou remova programas no painel de controle, selecione 2010 Microsoft Visual Studio ferramentas para o tempo de execução do Office na lista de programas e clique em desinstalar. O programa de instalação que é executado permite que você repare o runtime. Se você clicar em alterar, não receberá uma opção para reparar o tempo de execução.

Confira também