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

Artigo
08/08/2011

Para executar as soluções são criadas usando as ferramentas de desenvolvedor de Microsoft Office em Visual Studio 2010, 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 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 o aplicativo Microsoft Office e de sua solução. Para obter mais informações, consulte Noções básicas sobre as extensões do Office para o.NET Framework.
O carregador de solução do Office. Este componente é um conjunto de DLLs não gerenciados que usam de aplicativos do Office para carregar o runtime e suas soluções. Para obter mais informações, consulte Noções básicas sobre o carregador de solução do Office.

O tempo de execução pode ser instalado de diversas maneiras. Dependendo da configuração do computador, os componentes de tempo de execução diferentes são instalados quando você instala o runtime. For more information, see Visual Studio Tools para cenários de instalação do Office Runtime.

Noções básicas sobre as extensões do Office para o.NET Framework

O Visual Studio 2010 Tools for Office Runtime inclui duas extensões do Office para o.NET Framework:

As extensões do Office para o.NET Framework 3.5 são usados pelas soluções que visam o.NET Framework 3.5.
As extensões do Office para o .NET Framework 4 são usados pelas soluções destinadas a .NET Framework 4.

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 referências aos assemblies que são usados para o tipo de projeto e o destino.NET Framework do projeto. Para obter mais informações sobre assemblies em extensões do Office, consulte Assemblies no Visual Studio Tools para Office Runtime.

Diferenças de design de extensões do Office

A maioria dos tipos de que você usar as extensões do Office para o.NET Framework 3.5 são classes. Estas são as mesmas classes que foram incluídas nas versões anteriores da Visual Studio Tools for Office runtime. Em contraste, a maioria dos tipos que você usar as extensões do Office para o .NET Framework 4 são interfaces. Por exemplo, quando você direcionar o .NET Framework 4, o Microsoft.Office.Tools.Excel.Worksheet e Microsoft.Office.Tools.Word.Document são de tipos de interfaces em vez de classes.

Na maioria dos casos, o código que você escreve em soluções do Office é o mesmo se seus alvos da solução a.NET Framework 3.5 ou o .NET Framework 4. No entanto, alguns recursos requerem o código diferente ao selecionar diferentes versões do.NET Framework. For more information, see Migrando soluções do Office para o.NET Framework 4.

Interfaces de extensões do Office para o.NET Framework 4

A maioria das interfaces em extensões do Office para o .NET Framework 4 não se destinam a serem implementados pelo código do usuário. As interfaces somente é possível 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 futuras versões. Para criar objetos que implementam essas interfaces, usar os métodos fornecidos pelo Globals.Factory o objeto no seu projeto. Por exemplo, para obter um objeto que implementa o SmartTag interface, use o Globals.Factory.CreateSmartTag método. For more information about Globals.Factory, see Acesso global a objetos em projetos do Office.

Ativando a equivalência de tipo e tipos incorporados em projetos que visam o.NET Framework 4

O modelo de objeto baseado em interface das extensões do Office para o .NET Framework 4 permite que você use o recurso de equivalência de tipo no Visual C# 2010 e Visual Basic 2010 para incorporar informações de tipo da Visual Studio Tools for Office runtime na sua solução. Este recurso permite que soluções do Office e o Visual Studio Tools for Office runtime versão independentemente uns dos outros. Por exemplo, se sua solução utiliza o Microsoft.Office.Tools.Word.Document interface como um tipo de incorporado e a próxima versão do runtime adiciona membros para o Microsoft.Office.Tools.Word.Document interface, sua solução ainda funcionarão com a próxima versão do runtime. Se sua solução não usar o Microsoft.Office.Tools.Word.Document interface como um tipo de incorporado, e 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 que destinos de .NET Framework 4. Se você deseja ativar este recurso, defina a Incorporar tipos de interoperabilidade a propriedade de qualquer um dos seguintes referências de assembly em seu projeto para 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, informações de tipo para todos os tipos de tempo de execução usados pelo projeto estão incorporadas no assembly solução quando você constrói o projeto. Essas informações de tipo incorporados, em vez das informações de tipo em assemblies referenciados, são usadas pela solução em tempo de execução.

Noções básicas sobre o carregador de solução do Office

O Visual Studio Tools for Office em tempo de execução inclui diversas DLLs não gerenciadas que usam de aplicativos do Office para carregar o runtime e as soluções do Office. Embora você nunca deve ter que trabalhar com essas DLLs diretamente, sabendo que os objetivos dessas DLLs podem ajudá compreenda 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 em nível de documento e Arquitetura dos suplementos de nível de aplicativo.

VSTOEE.dll

Quando um usuário abre uma personalização em nível de documento ou inicia um add-in, o aplicativo do Office chama VSTOEE.dll para realizar as tarefas necessárias para carregar o Visual Studio Tools for Office runtime.

VSTOEE.dll certifica-se de que a versão correta do Visual Studio Tools for Office runtime é carregado para a solução e a versão instalada do Office. Embora várias versões do Visual Studio Tools for Office runtime pode ser instalado no mesmo computador, apenas uma instância de VSTOEE.dll está instalada no momento. Este é o VSTOEE.dll que foi incluída com a versão mais recente do tempo de execução instalada no computador. Para obter mais informações sobre as diferentes versões da 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 é carregada a versão apropriada do Visual Studio Tools for Office runtime, VSTOLoader.dll realiza a maior parte do trabalho que é necessário para carregar o assembly de solução. VSTOLoader.dll faz várias coisas:

Ele cria um domínio de aplicativo para cada conjunto de solução.
Ele executa um conjunto de verificações de segurança para verificar se o conjunto de solução tem permissão para executar.
Ele carrega a versão das extensões do Office para o.NET Framework é exigidos pela solução.

VSTOLoader.dll também faz várias coisas que são específicas para o add-ins:

Ele implementa o IDTExtensibility2 interface. IDTExtensibility2é uma interface COM que todos os suplementos para aplicativos de Microsoft Office devem implementar. Essa interface define os métodos que o aplicativo chama para se comunicar com o suplemento.
Ele implementa o IManagedAddin interface. Essa interface é usada pelos aplicativos do Office para ajudar a carregar suplementos em nível de aplicativo. For more information, see Interface de IManagedAddin.

Noções básicas sobre as versões de 32 bits e 64 bits do Runtime

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

Edição do Microsoft Windows	Edição do Microsoft Office	Versão necessária do Visual Studio Tools para Office runtime
32 bits	32 bits	32 bits
64 bits	32 bits	64 bits
64 bits	64 bits	64 bits

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

A versão de 64 bits do Microsoft Office 2010 também pode executar as soluções do Office que foram criadas usando modelos de projeto para o sistema de Microsoft Office de 2007 em 2008 de Visual Studio. No entanto, ele não é possível executar soluções do Office criadas usando-se em modelos de projeto para 2003 de Microsoft Office em Visual Studio de 2008 ou criadas usando o Visual Studio 2005 de soluções do Office. For more information, see Execução de soluções em diferentes versões do Microsoft Office.

Reparar as ferramentas de 2010 Visual Studio para 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 para Office Runtime na lista de programas e clique desinstalar. O programa de instalação é executado permite que você repare o tempo de execução. Se você clicar em alteração, você não tem uma opção para reparar o tempo de execução.

Consulte também

Compartilhar via