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

Artigo
08/25/2010

Para executar soluções que são criadas usando Ferramentas do Visual Studio para o Office, computadores de usuários finais devem ter o Tempo de execução Ferramentas do Visual Studio para o Office.O tempo de execução inclui assemblies gerenciados que fornecem a camada de comunicação entre a sua solução e o aplicativo Microsoft Office e componentes não gerenciados que o aplicativo usa para carregar a solução.

Para obter informações sobre como instalar o tempo de execução em computadores de usuários finais, consulte Como: Instalar o Visual Studio Tools para Office Tempo de execução.

Este tópico fornece as seguintes informações:

Noções básicas sobre as versões do tempo de execução diferente
Noções básicas sobre os assemblies de tempo de execução
Noções básicas sobre os componentes do carregador de tempo de execução

Noções básicas sobre as versões de tempo de execução diferente

Soluções de Ferramentas do Visual Studio para o Office para diferentes versões do Microsoft Office exigem diferentes versões do Tempo de execução.A versão de tempo de execução é determinada pelo modelo de projeto que foi usado para criar a solução, não pela versão do Office que está executando a solução.

A tabela a seguir mostra quais versões do Tempo de execução e Microsoft Office são necessários para executar soluções no computador de usuário final.

Versão do modelo de projeto	Versão de tempo de execução necessários Ferramentas do Visual Studio para o Office no computador usuário final	Versões do Microsoft Office que podem executar a solução no computador de usuário final
Projetos para o 2007 Microsoft Office Sistema	Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime)	Microsoft Office Sistema de 2007
Projetos para Microsoft Office 2003	O Visual Studio 2005 Tools for Office Second Edition runtime	Microsoft Office Sistema de 2007 Microsoft Office 2003

Versão do modelo de projeto

Versão de tempo de execução necessários Ferramentas do Visual Studio para o Office no computador usuário final

Versões do Microsoft Office que podem executar a solução no computador de usuário final

Projetos para o 2007 Microsoft Office Sistema

Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime)

Microsoft Office Sistema de 2007

Projetos para Microsoft Office 2003

O Visual Studio 2005 Tools for Office Second Edition runtime

Microsoft Office Sistema de 2007

Microsoft Office 2003

AmbAmbos Ambos versões do Tempo de execução são instalados automaticamente no computador de desenvolvimento quando você instala o Microsoft Visual Studio Tools para o sistema Microsoft Office (versão 3.0).

Para obter informações sobre a criação de soluções que podem ser executados com Ambos duAmbos versões do Microsoft Office, consulte Criação de soluções para Múltiplo versões do Microsoft Office.

Existem algumas diferenças entre os assemblies que são incluídos em cada versão do tempo de execução.Para obter mais informações, consulte diferenças de assembly.

Observação:
O O Visual Studio 2005 Tools for Office Second Edition runtime inicialmente foi lançado com Microsoft Visual Studio 2005 Tools para o 2007 Microsoft Office Sistema (O VSTO 2005 SE).Esta versão do Tempo de execução também é usado por soluções para o Microsoft Office 2003 que são criados usando Microsoft Visual Studio Tools para o sistema Microsoft Office (versão 3.0).

Localizar documentação de referência para Ambos Runtimes

Quando você Clique um link ou uma entrada de índice da Ajuda para obter informações de referência um Namespace, tipo ou membro, você poderá obter dois resultados quase idênticos.Os dois tópicos Documentoar os mesmos membros nas duas versões do tempo de execução.Selecionar o tópico que é identificado pelo indicador a versão apropriada:

Sistema de 2007.Refere-se para o Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime).
Sistema de 2003.Refere-se para o O Visual Studio 2005 Tools for Office Second Edition runtime.

Noções básicas sobre os assemblies em tempo de execução

Os módulos que estão incluídos no tempo de execução Ferramentas do Visual Studio para o Office fornecem as seguintes categorias de classes:

Classes que sua solução utiliza para automatizar e estender o aplicativo host.
Infra-estrutura de classes que permitem que sua solução para se comunicar com o aplicativo host.

Observação:
Quando você Criar um projeto, Ferramentas do Visual Studio para o Office adiciona automaticamente referências a assemblies que são usados para o tipo de projeto.Alguns dos assemblies são usados apenas em projetos de nível de documento, e outros são usados apenas em projetos de nível de aplicativo.

Assemblies do Visual Studio Tools para Office 3.0 Tempo de execução

A tabela a seguir lista os módulos que estão incluídos no Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime).Esta é a versão do tempo de execução usada pelo soluções criadas para o Microsoft Office Sistema de 2007.

Para documentação sobre os espaços para nome e classes nesses assemblies, consulte 2007 Sistema Gerenciado referência.

Nome do assembly	Descrição
Microsoft.Office.Tools.ComComumComum.v9.0.dll	Fornece as seguintes classes: A classe de base AddIn de nível de aplicativo Adicionar-ins. Classes para criação de painéis de ações e as marcas inteligentes em personalizações em nível de documento. Classes para criar painéis de tarefas Personalizars em nível de aplicativo Adicionar-ins. Classes para criar personalizações da Faixa de Opções. O ExcelLocale1033Attribute e classes de ExcelLocale1033Proxy, que são usados por soluções do Excel para controlar a Identificação da Localidade (LCID) usada para todas as chamadas de minúsculas da cultura para o modelo de objeto do Excel.For more information, see Formatação de dados no Excel com várias configurações regionais.
Microsoft.Office.Tools.Excel.v9.0.dll	Fornece itens de host e controles de host para personalizações de nível de documento do Excel.For more information, see Itens de host e Visão geral sobre controles de host.
Microsoft.Office.Tools.Outlook.v9.0.dll	Fornece classes que você pode usar para criar regiões de formulário Personalizar no Outlook Adicionar-ins.
Microsoft.Office.Tools.Word.v9.0.dll	Fornece os itens de host e controles de host para personalizações de nível de documento do Word.For more information, see Itens de host e Visão geral sobre controles de host.
Microsoft.Office.Tools.v9.0.dll	Fornece as seguintes classes: A classe RemoteBindableComponent, que fornece os recursos de ligação de dados para controles de host em personalizações em nível de documento. Outro classes que fazem parte da infra-estrutura de Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime) e não servem para ser usado diretamente em seu código.
Microsoft.VisualStudio.Tools.Applications.Tempo de execução.v9.0.dll	Fornece as seguintes classes: O atributo CachedAttribute e classes de ICachedType, que você pode usar para cache de objetos de dados em uma personalização de nível de documento. Exceções que podem ser geradas pelo Tempo de execução Ferramentas do Visual Studio para o Office. Outro classes que fazem parte da infra-estrutura de Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime) e não servem para ser usado diretamente em seu código.
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll	Fornece as seguintes classes: A classe ServerDocument, que você pode usar para anexar programaticamente assemblies de personalização para documentos e acessar os dados armazenados em cache em documentos. Várias classes que representam a hierarquia de armazenada em cache dados em uma personalização de nível de documento.
Microsoft.VisualStudio.Tools.Office.Tempo de execução.v9.0.dll	Fornece as seguintes classes: O AddInSecurityEntry e classes de UserInclusionList , que você pode usar para criar usuário inclusão entradas de lista para conceder Confiar a uma solução de Ferramentas do Visual Studio para o Office para o Microsoft Office Sistema de 2007.For more information, see Confiar em soluções do Office usando inclusão listas (Sistema de 2007). Outro classes que fazem parte da infra-estrutura de Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime) e não servem para ser usado diretamente em seu código.
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll	Fornecem classes que são parte da infra-estrutura Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime).Essas classes não são se destina a ser usado diretamente em seu código.

Assemblies no Visual Studio 2005 Tools for Office segundo Edition Tempo de execução

A tabela a seguir lista os módulos que estão incluídos no O Visual Studio 2005 Tools for Office Second Edition runtime.Esta é a versão do tempo de execução usada pelo soluções criadas para o Microsoft Office 2003.

Para documentação sobre os espaços para nome e classes nesses assemblies, consulte 2003 Sistema Gerenciado referência.

Nome do assembly	Descrição
Microsoft.Office.Tools.ComComumComum.dll	Fornece as seguintes classes: A classe de base AddIn de nível de aplicativo Adicionar-ins. Classes para criação de painéis de ações e as marcas inteligentes em personalizações em nível de documento.
Microsoft.Office.Tools.Excel.dll	Fornece itens de host e controles de host para personalizações de nível de documento do Excel.For more information, see Itens de host e Visão geral sobre controles de host.
Microsoft.Office.Tools.Word.dll	Fornece os itens de host e controles de host para personalizações de nível de documento do Word.For more information, see Itens de host e Visão geral sobre controles de host.
Microsoft.VisualStudio.Tools.Applications.Tempo de execução.dll	Fornece as seguintes classes: A classe ServerDocument, que você pode usar para anexar programaticamente as personalizações em documentos e acessar os dados armazenados em cache em documentos. O atributo CachedAttribute e classes de ICachedType, que você pode usar para cache de objetos de dados em uma personalização de nível de documento. Exceções que podem ser geradas pelo Tempo de execução Ferramentas do Visual Studio para o Office. Outro classes que fazem parte da infra-estrutura de O Visual Studio 2005 Tools for Office Second Edition runtime e não servem para ser usado diretamente em seu código.

Diferenças de assembly

Vários assemblies que estão incluídos no O Visual Studio 2005 Tools for Office Second Edition runtime têm nomes diferentes no Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime).Além disso, um assembly que faz parte o O Visual Studio 2005 Tools for Office Second Edition runtime foi Dividir em vários novos assemblies in the Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime).

A tabela a seguir lista as diferenças.

Nome do assembly em que o O Visual Studio 2005 Tools for Office Second Edition runtime	Nome do assembly em que o Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime)
Microsoft.Office.Tools.ComComumComum.dll	Microsoft.Office.Tools.ComComumComum.v9.0.dll
Microsoft.Office.Tools.Excel.dll	Microsoft.Office.Tools.Excel.v9.0.dll
Microsoft.Office.Tools.Word.dll	Microsoft.Office.Tools.Word.v9.0.dll
Microsoft.VisualStudio.Tools.Applications.Tempo de execução.dll	Microsoft.VisualStudio.Tools.Applications.Tempo de execução.v9.0.dll Algumas classes também foram movidos para os seguintes assemblies novos: Microsoft.Office.Tools.v9.0.dll Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

Noções básicas sobre os componentes do carregador de tempo de execução

O Tempo de execução Ferramentas do Visual Studio para o Office inclui diversas DLLs não gerenciados que aplicativos do Microsoft Office usam para carregar Ferramentas do Visual Studio para o Office soluções.Embora você deve nunca precise trabalhar com essas DLLs diretamente, conhecer que os fins essas DLLs podem ajudar melhor compreenda a arquitetura de soluções de Ferramentas do Visual Studio para o Office.

Para obter informações sobre como esses componentes são usados durante o Carregar processo, consulte Arquitetura de personalizações de nível de documento e Arquitetura de nível de aplicativo Adicionar-ins.

Carregador de tempo de execução

Quando um usuário abre uma personalização de nível de documento ou inicia um Adicionar-in, o aplicativo Microsoft Office chama o carregador de tempo de execução.Esse componente é denominado VSTOEE.dll.

O carregador de tempo de execução garante que a versão correta do runtime Ferramentas do Visual Studio para o Office é carregada para a versão do Microsoft Office que está carregando o Adicionar-in.Embora Múltiplo versões do Tempo de execução Ferramentas do Visual Studio para o Office podem ser instaladas no mesmo computador, apenas uma instância de VSTOEE.dll está instalada por vez.Este é o VSTOEE.dll que foi incluída com a versão mais recente do Tempo de execução instalado no computador.

Carregador de solução

O carregador de solução executa a maioria do trabalho necessário para carregar o assembly de solução.O carregador de solução tem nomes de arquivo diferentes dependendo da versão do Tempo de execução Ferramentas do Visual Studio para o Office.O carregador de solução no Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime) é denominado VSTOLoader.dll.Em O Visual Studio 2005 Tools for Office Second Edition runtime, ele é denominado AddinLoader.dll.

O carregador de solução faz várias coisas:

Ele cria um novo domínio de aplicativo para cada assembly de solução Ferramentas do Visual Studio para o Office.
Ele executa um conjunto de verificações de segurança para verificar se o Adicionar - no assembly tem permissão para executar.

O carregador de solução também faz várias coisas que são específicas para Adicionar-ins:

Ele implementa a interface de IDTExtensibility2.IDTExtensibility2 é uma COM interface que Tudo Adicionar-ins para aplicativos do Microsoft Office deve implementar.Esta interface define métodos que o aplicativo chama para se comunicar com o Adicionar-in.
Ele implementa a interface de IManagedAddin.Essa interface é usada por aplicativos do Office, iniciando no versão 2007, para ajudar a carregar Ferramentas do Visual Studio para o Office Adicionar-ins.For more information, see Interface IManagedAddin.

Consulte também

Partilhar via