Visão geral do tempo de execução do Visual Studio Tools for Office

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

As extensões do Office para o .NET Framework. Esses componentes são assemblies gerenciados que fornecem a camada de comunicação entre sua solução e o aplicativo do Microsoft Office. Para obter mais informações, consulte Compreender as extensões do Office para o .NET Framework.
O carregador de soluções do Office. Este componente é um conjunto de DLLs não gerenciadas que os aplicativos do Office usam para carregar o tempo de execução e suas soluções. Para obter mais informações, consulte Compreender o carregador de soluções do Office.

O runtime pode ser instalado de várias maneiras diferentes. Dependendo da configuração do computador, diferentes componentes de runtime são instalados quando se instala o runtime. Para obter mais informações, consulte Visual Studio Tools for Office runtime installation scenarios.

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

O Visual Studio 2010 Tools for Office runtime inclui extensões do Office para o .NET Framework 3.5, o .NET Framework 4 e posterior. As soluções destinadas 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 Visual Studio Tools for Office runtime.

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 do Visual Studio Tools for 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 se tem como alvo 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, quer sua solução tenha como alvo o .NET Framework 3.5 ou o .NET Framework 4. No entanto, determinados recursos exigem código diferente quando se focam em 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 destinam a ser implementadas 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 Visual Studio 2010 Tools for Office runtime, e essas interfaces podem mudar em versões futuras. Para criar objetos que implementam essas interfaces, use métodos Globals.Factory fornecidos pelo 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 Acesso global a objetos em projetos do Office.

Habilitar a equivalência de tipos e tipos incorporados em projetos destinados ao .NET Framework 4 ou posterior

Como o modelo de objeto das extensões do Office para o .NET Framework 4 ou posterior são baseados em interfaces, você pode usar o recurso de equivalência de tipo no Visual C# e no Visual Basic no Visual Studio para incorporar informações de tipo do Visual Studio Tools for Office runtime em sua solução. Esse recurso permite que as soluções do Office e o tempo de execução do Visual Studio Tools for Office sejam versões independentes uma da outra. Por exemplo, se sua solução usa a Document interface como um tipo incorporado e a próxima versão do tempo de execução adiciona membros à Document interface, sua solução ainda funcionará com a próxima versão do tempo de execução. Se sua solução não usar a Document interface como um tipo incorporado, 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 destinado ao .NET Framework 4 ou posterior. Se você quiser habilitar esse recurso, defina a propriedade Embed Interop Types 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 tempo de execução usados pelo projeto são incorporadas no assembly da solução quando você cria o projeto. Essas informações de tipo incorporadas, em vez das informações de tipo nas compilações referenciadas, são usadas pela solução em tempo de execução.

Compreender o carregador de soluções 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 DLLs diretamente, 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 carregamento, consulte Arquitetura de personalizações no nível de documento e Arquitetura de suplementos VSTO.

VSTOEE.dll

Quando um usuário abre uma personalização no nível de 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 Visual Studio Tools for Office runtime é carregada para a solução e a versão instalada do Office. Embora várias versões do Visual Studio Tools for 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 na versão mais recente do tempo de execução instalada no computador. Para obter mais informações sobre as diferentes versões do Visual Studio Tools for Office runtime que podem ser usadas para outras soluções, consulte Executar soluções em diferentes versões do Microsoft Office.

VSTOLoader.dll

Depois de VSTOEE.dll carregar a versão apropriada do Visual Studio Tools for 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 aplicação para cada assembly da 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 é exigido pela solução.

VSTOLoader.dll também faz várias coisas que são específicas para suplementos VSTO:
Ele implementa a IDTExtensibility2 interface. IDTExtensibility2 é uma interface COM que todos os suplementos VSTO para aplicações Office devem implementar. Esta interface define métodos que a aplicação chama para comunicar-se com o suplemento VSTO.
Ele implementa a interface IManagedAddin. Esta Interface é usada pelas aplicações do Office para ajudar a carregar suplementos VSTO. Para obter mais informações, consulte Interface IManagedAddin.

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

Há versões separadas de 64 bits e 32 bits do Visual Studio 2010 Tools for Office runtime. Essas versões do tempo de execução são usadas para executar soluções nas edições de 64 bits e 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-bit	32 bits	64-bit
64-bit	64-bit	64-bit

Quando você instala o Office, a versão necessária do Visual Studio Tools for 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 for Office runtime também é instalada. Para obter mais informações sobre como instalar o Visual Studio Tools for Office runtime com o Office, consulte Visual Studio Tools for Office runtime installation scenarios.

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 2007 Microsoft Office system 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 o runtime do Visual Studio 2010 Tools for Office

Se você precisar reparar o tempo de execução, abra Programas e Recursos ou Adicionar ou Remover Programas no Painel de Controle, selecione Microsoft Visual Studio 2010 Tools for Office Runtime na lista de programas e clique em Desinstalar. O programa de instalação que é executado permite que você repare o tempo de execução. Se você clicar em Alterar, não terá uma opção para reparar o tempo de execução.

Feedback

Esta página foi útil?

Last updated on 2025-12-12