Arquitetura dos suplementos de nível de aplicativo

Artigo
02/25/2013

Suplementos criado usando as ferramentas do desenvolvedor do Office no Visual Studio tem os recursos arquitectónicos que sublinham estabilidade e segurança, e ativá-las para trabalhar com a Microsoft Office.Este tópico descreve os seguintes aspectos de suplementos:

Suplementos compreensivo
Componentes de suplementos
Como trabalho suplementos com aplicativos do Microsoft Office

Aplicável a: As informações neste tópico se aplicam a projetos em níveis de aplicativo o Microsoft Office 2013 e o Microsoft Office 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para obter informações gerais sobre como criar adendos, consulte o Visão geral de desenvolvimento de soluções do Office e Obtendo suplementos de nível de programação de aplicativo foi iniciado.

Suplementos compreensivo

Quando você usa ferramentas do desenvolvedor do Office no Visual Studio para criar um suplemento, você cria um assembly de código gerenciado que é carregado por um aplicativo do Microsoft Office.Depois que o assembly é carregado, o suplemento pode responder a eventos que são criados no aplicativo (por exemplo, quando um usuário clica em um item de menu).O suplemento também pode chamar no modelo de objeto para automatizar e estender o aplicativo, e pode usar qualquer uma das classes em .NET Framework.

O assembly se comunica com componentes COM do aplicativo através do assembly de interoperabilidade primário do aplicativo.Para obter mais informações, consulte Assemblies de interoperabilidade primária do Office e Visão geral de desenvolvimento de soluções do Office.

Se os suplementos de vários é instalado para um aplicativo, cada suplemento é carregado em um domínio de aplicativo diferente.Isso significa que aquele um suplemento que se comporta incorretamente não pode causar outro suplementos falhar.Também ajuda a garantir que quando o aplicativo é fechado, todos os assemblies do suplemento serem descarregados de memória.Para obter mais informações sobre domínios de aplicativos, consulte Domínios de aplicativo.

Observação
Suplementos que você cria usando o desenvolvedor do Office usa ferramentas no Visual Studio é projetado para ser usado somente quando o aplicativo do Microsoft Office host é inicializado por um usuário final.Se o aplicativo é iniciado programaticamente (por exemplo, usando automação), o suplemento pode não funcionar como esperado.

Componentes de suplementos

Embora o assembly do suplemento é o componente principal, há vários outros componentes que executam uma função importante em como os aplicativos do Microsoft Office descobrem e carregar suplementos.

Entradas do Registro

Os aplicativos do Microsoft Office descobrem suplementos procurando um conjunto de entradas do Registro.Para obter uma lista completa das entradas do Registro usadas pelos suplementos, consulte Entradas de registro de suplementos em nível de aplicativo.

Quando você cria sua solução, o Visual Studio cria todas as entradas necessárias do Registro no computador de desenvolvimento para que você possa depurar e executar o suplemento.Para obter mais informações, consulte Construindo soluções do Office.

Se você usar o ClickOnce para implantar sua solução, o programa de instalação gerado pelo processo de publicação cria automaticamente as chaves do Registro no computador do usuário final.Para obter mais informações, consulte Implantando uma solução do Office usando o ClickOnce.

Manifesto de implantação e manifesto do aplicativo

Manifestos de implantação de uso suplementos e manifestos de aplicativo para identificar e carregar a versão atual do suplemento.Os pontos de manifesto de implantação para o aplicativo atual oferece.Os pontos de manifesto de aplicativo ao assembly do suplemento, e especifique a classe do ponto de entrada para executar o assembly.Para obter mais informações, consulte Manifestos de aplicativo e implantação em soluções do Office.

O Visual Studio para o tempo de execução do Office

Para executar suplementos que são criados usando as ferramentas do desenvolvedor do Office no Visual Studio, o usuário final que os computadores devem ter Visual Studio Tools for Office Runtime instalado. O tempo de execução inclui componentes não gerenciados e um conjunto de módulos (assemblies) gerenciados.Os componentes não gerenciados carregar o assembly do suplemento.Assemblies gerenciados fornecem o modelo de objeto que o código do suplemento usa para automatizar e estendem o aplicativo host.

Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Como trabalho suplementos com aplicativos do Microsoft Office

Quando um usuário inicia um aplicativo do Microsoft Office, o aplicativo usa o manifesto de implantação e o manifesto do aplicativo para localizar e carregar a versão atual do suplemento.A ilustração a seguir mostra a arquitetura básica desses suplementos.

Arquitetura do suplemento

Arquitetura de suplemento do office de 2007

Observação
Em soluções do Office que direcionam .NET Framework 4 ou .NET Framework 4.5, chamada de soluções no modelo de objeto do aplicativo host usando informações de tipo de PIA que é inserida no assembly de solução, em vez de chamada no PIA diretamente.Para obter mais informações, consulte Projetando e criando soluções do Office.

Processo de carregamento

As seguintes etapas ocorrem quando um usuário inicia um aplicativo:

O aplicativo verifica o Registro para as entradas que identificam suplementos que foi criado usando as ferramentas do desenvolvedor do Office no Visual Studio.
Se o aplicativo encontra essas entradas do Registro, o aplicativo carrega VSTOEE.dll, que carrega VSTOLoader.dll.Esses são dlls não gerenciadas que são os componentes do carregador para o 2010 Visual Studio Tools for Office Runtime.Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.
VSTOLoader.dll carrega .NET Framework e inicia a parte de Visual Studio Tools for Office Runtimegerenciado.
Visual Studio Tools for Office Runtime verifica se há atualizações de manifesto, e baixa os mais recentes os manifestos de aplicativo e implantação.
Visual Studio Tools for Office Runtime executa uma série de verificações de segurança.Para obter mais informações, consulte Protegendo soluções do Office.
Se o suplemento é confiável para executar, Visual Studio Tools for Office Runtime usa o manifesto de implantação e o manifesto do aplicativo para verificar se há atualizações de assemblies.Se uma nova versão do assembly estiver disponível, o tempo de execução download da nova versão do assembly no cache de ClickOnce no computador cliente.Para obter mais informações, consulte Implantando uma solução do Office.
Visual Studio Tools for Office Runtime cria um novo domínio de aplicativo no qual carregar o assembly do suplemento.
Visual Studio Tools for Office Runtime carrega o assembly do suplemento no domínio de aplicativo.
Visual Studio Tools for Office Runtime chama o método de RequestComAddInAutomationService no suplemento, se você o substituiu.

Você pode opcionalmente substituir esse método para expor um objeto no suplemento a outras soluções do Office.Para obter mais informações, consulte Chamar código nos suplementos de nível de aplicativo de outras soluções do Office.

Visual Studio Tools for Office Runtime chama o método de RequestService no suplemento, se você o substituiu.

Você pode opcionalmente substituir esse método para estender um recurso do Microsoft Office retornando um objeto que implementa uma interface de extensibilidade.Para obter mais informações, consulte Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade.

Observação
Visual Studio Tools for Office Runtime faz chamadas para o método de RequestService separados para cada interface de extensibilidade que é suportada pelo aplicativo host.Embora a primeira chamada para o método de RequestService geralmente ocorre antes da chamada para o método de ThisAddIn_Startup , o suplemento não deve fazer qualquer suposições sobre quando o método de RequestService será chamado, ou quantas vezes será chamado.

Visual Studio Tools for Office Runtime faz chamadas para o método de RequestService separados para cada interface de extensibilidade que é suportada pelo aplicativo host.Embora a primeira chamada para o método de RequestService geralmente ocorre antes da chamada para o método de ThisAddIn_Startup , o suplemento não deve fazer qualquer suposições sobre quando o método de RequestService será chamado, ou quantas vezes será chamado.

Visual Studio Tools for Office Runtime chama o método de ThisAddIn_Startup no suplemento.Este método é o manipulador de eventos padrão para o evento de Startup .Para obter mais informações, consulte Eventos em projetos do Office.