Entradas de registro de suplementos em nível de aplicativo

Você deve criar um conjunto específico de entradas do registro quando você implanta os suplementos que são criados usando Visual Studio 2010. Essas entradas do registro fornecem informações que permite que o aplicativo de Microsoft Office descobrir e carregar o suplemento.

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

Quando você compila seu projeto, o Visual Studio cria essas entradas do registro no computador de desenvolvimento, para que você pode facilmente executar e depurar o suplemento. Se você usar ClickOnce para implantar seu suplemento, as entradas do registro são criadas automaticamente no computador do usuário final. Se você usar o Windows Installer para implantar seu suplemento, você deve configurar o projeto de instalação para criar as entradas do registro no computador do usuário final.

Para obter mais informações sobre como as entradas do registro são usadas durante o processo de carregamento de suplementos, consulte Arquitetura dos suplementos de nível de aplicativo.

ObservaçãoObservação

Neste tópico, o texto na ID. de- representa uma identificação exclusiva para seu suplemento. Por padrão, a identificação é o nome do seu assembly do suplemento.

Registrando o Add-ins para o vs do usuário atual.Todos os usuários

Quando um add-in é instalado, ele pode ser registrado de duas maneiras:

  • Para o usuário atual (ou seja, ele está disponível somente ao usuário que está conectado ao computador quando o suplemento está instalado). Nesse caso, as entradas do registro são criadas em HKEY_CURRENT_USER.

  • Para todos os usuários (ou seja, qualquer usuário que faz logon no computador pode usar o add-in). Nesse caso, as entradas do registro são criadas em HKEY_LOCAL_MACHINE.

Todos os suplementos que você cria usando Visual Studio 2010 pode ser registrado para o usuário atual. No entanto, os suplementos podem ser registrados para todos os usuários somente em determinados cenários. Esses cenários dependem da versão do Microsoft Office no computador e como o suplemento foi implantado.

Versão de Microsoft Office

Aplicativos de 2010 de Microsoft Office podem carregar suplementos que são registrados em HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER.

Por padrão, os aplicativos no sistema de Microsoft Office de 2007 só podem carregar suplementos que são registrados em HKEY_CURRENT_USER. Para carregar os suplementos que estão registrados em HKEY_LOCAL_MACHINE, os computadores que possuem esses aplicativos instalados também devem ter o pacote de hotfix 976477 instalado. Para obter mais informações, consulte https://go.microsoft.com/fwlink/?LinkId=184923.

Tipo de implantação

Se você usar ClickOnce para implantar um add-in, add-in pode ser registrado apenas para o usuário atual. Isso ocorre porque o ClickOnce só oferece suporte a criação de chaves em HKEY_CURRENT_USER. Se você deseja registrar um suplemento para todos os usuários em um computador, você deve usar o Windows Installer para implantar o add-in. Para obter mais informações sobre esses tipos de implantação, consulte Soluções do Office de publicação e Implantar uma solução Office usando o Windows Installer.

Entradas do registro

Entradas de registro de suplemento necessárias estão localizadas na seguinte chave do registro para todos os aplicativos exceto o Visio, onde raiz é HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE.

Raiz\Software\Microsoft\Office\nome do aplicativo\Addins\ID de suplemento

Para o Visio, as entradas do registro se pertencer sob a seguinte chave do registro.

Raiz\Software\Microsoft\Visio\Addins\ID de suplemento

A tabela a seguir lista as entradas nesta chave do registro.

Entry

Type

Value

Description

REG_SZ

Required. Uma breve descrição do suplemento.

Essa descrição é exibida quando o usuário seleciona o suplemento no Add-Ins o painel da Opções caixa de diálogo no aplicativo Microsoft Office.

FriendlyName

REG_SZ

Required. Um nome descritivo do add-in que é exibido na Suplementos COM caixa de diálogo no aplicativo Microsoft Office. O valor padrão é o ID de.

LoadBehavior

REG_DWORD

Required. Um valor que especifica quando o aplicativo tenta carregar o suplemento e o estado atual do suplemento (carregado ou descarregado).

Por padrão, essa entrada é definida como 3, que especifica que o suplemento seja carregado na inicialização. Para obter mais informações, consulte LoadBehavior valores.

Manifest

REG_SZ

Required. O caminho completo do manifesto de implantação para o suplemento. O caminho pode ser um local no computador local, um compartilhamento de rede (UNC) ou um servidor Web (HTTP).

Se você usar o Windows Installer para implantar a solução, anexe a string |vstolocal (ou seja, o caractere de pipe |seguido por vstolocal) no final deste caminho. Isso garante que sua solução for carregada a partir da pasta de instalação, em vez do cache de ClickOnce. For more information, see Implantar uma solução Office usando o Windows Installer.

ObservaçãoObservação
Quando você cria um add-in no computador de desenvolvimento, Visual Studio anexará automaticamente o |vstolocal seqüência a essa entrada do registro.

Warmup

REG_DWORD

Optional. Um valor que indica que o.NET Framework e Visual Studio Tools for Office runtime carregar antes que um suplemento carrega e reduzir o tempo de percepção para carregar um add-in. Definir o Warmup entrada 1 e usá-lo em conjunto com LoadBehavior a entrada para reduzir o tempo de carga para o Outlook 2010 suplementos que são implantados usando o Windows Installer (. msi). Essa chave do registro não pode ser definida usando o ClickOnce.

Entradas do registro para regiões de formulário do Outlook

Se você criar uma região de formulário personalizado em um suplemento para Outlook, as entradas do Registro adicionais são usadas para registrar a região de formulário com o Outlook. Essas entradas são criadas em uma chave do registro diferente para cada classe de mensagem que ofereça suporte a região de formulário. Essas chaves do registro estão no seguinte local, onde raiz é HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE.

Raiz\Software\Microsoft\Office\Outlook\FormRegions\a classe de mensagem

Como as outras entradas do registro compartilhadas por todos os suplementos, Visual Studio cria o formulário entradas de registro de região no computador de desenvolvimento quando você compila seu projeto. Se você usar ClickOnce para implantar seu suplemento, as entradas do registro são criadas automaticamente no computador do usuário final. Se você usar o Windows Installer para implantar seu suplemento, você deve configurar o projeto de instalação para criar as entradas do registro no computador do usuário final.

Para obter mais informações sobre as entradas de registro de região de formulário, consulte Especificando a regiões de formulário no registro do Windows. Para obter mais informações sobre regiões de formulário do Outlook, consulte Criação de regiões de formulário do Outlook.

Valores de LoadBehavior

O LoadBehavior entrada sob a raiz\Software\Microsoft\Office\nome do aplicativo\Addins\ID de- chave contém uma combinação bit a bit dos valores que especificam o comportamento de tempo de execução do suplemento. O menor bit de ordem (valores 0 e 1) indica se o suplemento é atualmente descarregado ou carregado. Outros bits indicam quando o aplicativo tenta carregar o suplemento.

Normalmente, o LoadBehavior entrada se destina a ser definido como 0, 3 ou 16 (em decimal) quando o suplemento está instalado em computadores de usuário final. Por padrão, o Visual Studio define o LoadBehavior entrada do seu suplemento 3 ao construir ou publicar o proprietário.

A tabela a seguir lista todos os possíveis valores de LoadBehavior entrada. Algumas descrições nesta tabela consultem carregando um add-in manualmente ou programaticamente. Para carregar um suplemento, manualmente, marque a caixa de seleção próxima ao suplemento no Suplementos COM caixa de diálogo no aplicativo. Para carregar um suplemento programaticamente, defina a Connect propriedade da COMAddIn objeto que representa o add-in para true.

Valor (em decimal)

Status do suplemento

Comportamento de carregamento do suplemento

Description

0

Descarregado

Não carregue automaticamente

O aplicativo nunca tenta carregar o suplemento automaticamente. O usuário pode tentar carregar manualmente o add-in ou add-in pode ser carregado por meio de programação.

Se o suplemento é carregado com êxito, o LoadBehavior valor permanece 0, mas o status do suplemento na suplementos COM caixa de diálogo é atualizada para indicar que o suplemento seja carregado.

1

Loaded

Não carregue automaticamente

O aplicativo nunca tenta carregar o suplemento automaticamente. O usuário pode tentar carregar manualmente o add-in ou add-in pode ser carregado por meio de programação.

Embora o suplementos COM caixa de diálogo indica que o suplemento é carregado após o aplicativo for iniciado, o suplemento não estiver carregado até que ele seja carregado manualmente ou programaticamente.

Se o aplicativo é carregado com êxito o add-in, o LoadBehavior valor é alterado para 0 e permanece em 0 depois que o aplicativo é fechado.

2

Descarregado

Carregar na inicialização

O aplicativo não tenta carregar o suplemento automaticamente. O usuário pode tentar carregar manualmente o add-in ou add-in pode ser carregado por meio de programação.

Se o aplicativo é carregado com êxito o add-in, o LoadBehavior valor muda para 3 e permanece em 3 após o fechamento do aplicativo.

3

Loaded

Carregar na inicialização

O aplicativo tenta carregar o suplemento quando o aplicativo for iniciado. Este é o valor padrão quando você construir ou publica um suplemento em Visual Studio.

Se o aplicativo é carregado com êxito o add-in, o LoadBehavior valor permanece 3. Ocorrer um erro ao carregar o suplemento, o LoadBehavior valor é alterado para 2 e permanece em 2 após o fechamento do aplicativo.

8

Descarregado

Carregar sob demanda

O aplicativo não tenta carregar o suplemento automaticamente. O usuário pode tentar carregar manualmente o add-in ou add-in pode ser carregado por meio de programação.

Se o aplicativo é carregado com êxito o add-in, o LoadBehavior valor é alterado para 9.

9

Loaded

Carregar sob demanda

O suplemento será carregado somente quando o aplicativo requer, como, por exemplo, quando um usuário clica em um elemento de interface do usuário que usa a funcionalidade no suplemento (por exemplo, um botão personalizado na faixa de opções).

Se o aplicativo é carregado com êxito o add-in, o LoadBehavior valor permanece 9, mas o status do suplemento na suplementos COM caixa de diálogo é atualizada para indicar que o suplemento está atualmente carregado. Ocorrer um erro ao carregar o suplemento, o LoadBehavior valor é alterado para 8.

16

Loaded

Carregar pela primeira vez, em seguida, carregar sob demanda

Defina esse valor se desejar que seu suplemento seja carregado sob demanda. O aplicativo carrega o suplemento quando o usuário executa o aplicativo pela primeira vez. Na próxima vez em que o usuário executa o aplicativo, o aplicativo carrega quaisquer elementos de interface do usuário são definidos pelo suplemento, mas o suplemento não será carregado até o usuário clica em um elemento de interface do usuário que está associado com o suplemento.

Quando o aplicativo carrega com êxito o add-in pela primeira vez, o LoadBehavior valor permanece 16 enquanto o suplemento é carregado. Depois que o aplicativo for fechado, a LoadBehavior valor é alterado para 9.

Consulte também

Conceitos

Arquitetura dos suplementos de nível de aplicativo

Visão Geral do Processo de Compilação de uma Solução Office

Outros recursos

Arquitetura de soluções do Office em Visual Studio

Implantar soluções do Office

Histórico de alterações

Date

History

Motivo

Maio de 2010

Fornecido mais contexto sobre o uso de |vstolocal na entrada do manifesto.

Aprimoramento de informações.