Visual Studio Tools for Office visão geral sobre o tempo de execução

Artigo
03/22/2013

Para executar soluções criadas usando as ferramentas do desenvolvedor do Microsoft Office em Visual Studio 2012, o Visual Studio 2010 Tools for Office Runtime deve ser instalado em computadores de usuário final.O Visual Studio 2010 Tools for Office Runtime consiste de 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 Entendendo as extensões do Office para o .NET Framework.
O carregador de solução do Office.Este componente é um conjunto de DLL não gerenciado que os aplicativos do Office usam para carregar o tempo de execução e suas soluções.Para obter mais informações, consulte Entendendo o carregador de solução do Office.

O tempo de execução pode ser instalado em várias maneiras diferentes.Dependendo da configuração do computador, os diferentes componentes de tempo de execução são instalados quando você instala o tempo de execução.Para obter mais informações, consulte O Visual Studio Tools para cenários de instalação do Office Runtime.

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

O 2010 Visual Studio Tools for Office Runtime inclui as extensões do Office para o .NET Framework 3.5, .NET Framework 4, e .NET Framework 4.5.Soluções que apontam para cada versão do .NET Framework usam as extensões apropriadas para aquela 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 as referências aos assemblies que são usados para o tipo de projeto e o destino do .NET Framework projeto.Para obter mais informações sobre assemblies nas extensões do Office, consulte Módulos (assemblies) no Visual Studio Tools para Office Runtime.

Criar diferenças 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 de Visual Studio Tools for Office Runtime. Por outro lado, a maioria dos tipos que você usa nas extensões do Office para .NET Framework 4 e .NET Framework 4.5 são interfaces.Por exemplo, quando você utiliza .NET Framework 4 ou .NET Framework 4.5, os tipos de Microsoft.Office.Tools.Excel.Worksheet e de Microsoft.Office.Tools.Word.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 destino do .NET Framework 3.5 ou .NET Framework 4.No entanto, alguns recursos exigem o código diferente quando você utiliza versões diferentes do.NET Framework.Para obter mais informações, consulte Migrando soluções do Office para o .NET Framework 4 ou o .NET Framework 4.5.

Interfaces nas extensões do Office para o .NET Framework 4 e .NET Framework 4.5

A maioria das interfaces nas extensões do Office para .NET Framework 4 e de .NET Framework 4.5 não se destinam ser implementados 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 por 2010 Visual Studio Tools for Office, Runtime e por essas interfaces podem alterar em versões futuras.Para criar objetos que implementam essas interfaces, os métodos de uso fornecidos por Globals.Factory objeto no seu projeto.Por exemplo, para obter um objeto que implementa a interface de SmartTag , use o método de Globals.Factory.CreateSmartTag .Para obter mais informações sobre Globals.Factory, consulte Acesso global a objetos em projetos do Office.

Ativando equivalência do tipo e inserido em projetos que destinam-se o .NET Framework 4 e .NET Framework 4.5

Porque o modelo de objeto de extensões do Office para .NET Framework 4 e .NET Framework 4.5 é baseado em interfaces, você pode usar o recurso de equivalência de tipo no Visual C# e Visual Basic em Visual Studio 2012 para inserir informações sobre o tipo de Visual Studio Tools for Office Runtime em sua solução. Este recurso permite soluções do Office e Visual Studio Tools for Office Runtime à versão independentemente de se.Por exemplo, se sua solução usa a interface de Microsoft.Office.Tools.Word.Document como um tipo inserido e a próxima versão de tempo de execução adiciona membros a interface de Microsoft.Office.Tools.Word.Document , sua solução ainda irá trabalhar com a próxima versão de tempo de execução.Se sua solução não usa a interface de Microsoft.Office.Tools.Word.Document como um tipo inserido, então sua solução já não funcionará com a próxima versão de tempo de execução.

Por padrão, o recurso de equivalência de tipo não é ativado quando você cria um projeto do Office que tem como alvo .NET Framework 4 ou .NET Framework 4.5.Se você deseja ativar esse recurso, defina a propriedade de Inserir Tipos Interop algumas das seguintes referências 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

Após fazer essa alteração, digite informações para todos os tipos de tempo de execução usados pelo projeto está inserido no assembly de solução ao criar o projeto.Essa informação inserida de tipo, em vez de informações de tipo em assemblies referenciados, é usada pela solução em tempo de execução.

Entendendo o carregador de solução do Office

O Visual Studio para o tempo de execução do Office inclui vários DLL não gerenciado que os aplicativos do Office usam para carregar o tempo de execução e soluções do Office.Embora você nunca deve ter que trabalhar com esses DLL diretamente, saber as finalidades dessas dlls melhor pode ajudar você a entender a arquitetura de 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 dos suplementos de nível de aplicativo.

VSTOEE.dll

Quando um usuário abrir uma personalização da nível ou iniciar um suplemento, o aplicativo chama do Office em VSTOEE.dll para executar as tarefas necessárias para carregar Visual Studio Tools for Office Runtime.

VSTOEE.dll certifique-se de que a versão correta de Visual Studio Tools for Office Runtime é carregada para a solução e a instalação do Office.Embora as várias versões de Visual Studio Tools for Office Runtime podem ser instaladas no mesmo computador, somente uma instância de VSTOEE.dll é instalada em 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 versões diferentes de Visual Studio Tools for Office Runtime que pode ser usado para outras soluções, consulte Execução de soluções em diferentes versões do Microsoft Office.

VSTOLoader.dll

Depois que VSTOEE.dll carrega a versão apropriada de Visual Studio Tools for Office Runtime, VSTOLoader.dll executa a maioria de trabalho que é necessária carregar o assembly de 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 que o assembly de solução tem permissão para executar.
Carrega a versão das extensões do Office para o.NET Framework que é necessária pela solução.

VSTOLoader.dll também faz várias coisas que são específicas a suplementos:

Implementa a interface de IDTExtensibility2 .IDTExtensibility2 é uma interface COM que qualquer suplementos para aplicativos do Microsoft Office deve implementar.Essa interface define métodos que o aplicativo chama para se comunicar com o suplemento.
Implementa a interface de IManagedAddin .Essa interface é usada por aplicativos do Office ajudar a carregar suplementos do aplicativo.Para obter mais informações, consulte Interface IManagedAddin.

Entendendo as versões de 32 bits e 64 bits em tempo de execução

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

Edição do Windows	Edição do Microsoft Office	Necessário versão do Visual Studio para o tempo de execução do Office
32 bits	32 bits	32 bits
64 bits	32 bits	64 bits
64 bits	64 bits	64 bits

Quando você instala Office 2013 ou Office 2010, a versão de Visual Studio Tools for Office Runtime necessário está instalado junto com o Office.Por exemplo, quando você instala a edição de 64 bits de Office 2013 ou de Office 2010 em uma versão de 64 bits do Windows, a versão de 64 bits de Visual Studio Tools for Office Runtime é instalada também.Para obter mais informações sobre como instalar Visual Studio Tools for Office Runtime com Office 2013 ou Office 2010, consulte o O Visual Studio Tools para cenários de instalação do Office Runtime.

A versão de 64 bits de Office 2013 ou de Office 2010 também pode executar as soluções do Office que foram criadas usando modelos de projeto para 2007 Microsoft Office system no Visual Studio 2008.No entanto, não pode executar as 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 Visual Studio 2005.Para obter mais informações, consulte Execução de soluções em diferentes versões do Microsoft Office.

Reparando 2010 Visual Studio Tools for Office Runtime

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 dos programas, e clique em Desinstalar.O programa de instalação que executa permite que você reparar o tempo de execução.Se você clicar em Alterar, você não é fornecida uma opção para reparar o tempo de execução.

Consulte também

Compartilhar via