Entradas de registro de suplementos em nível de aplicativo

Artigo
02/25/2013

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

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.

Quando você compila seu projeto, o Visual Studio cria essas entradas no Registro do computador de desenvolvimento de modo que você pode facilmente executar e depurar o suplemento.Se você usar o ClickOnce para implantar seu suplemento, as entradas de Registro são criados automaticamente no computador do usuário final.Se você usar Windows Installer para implantar seu suplemento, você deve configurar o projeto de edição limitada de InstallShield 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 para suplementos, consulte Arquitetura dos suplementos de nível de aplicativo.

Observação
Neste tópico, o texto identificação do suplemento representa um ID exclusivo para o suplemento.Por padrão, o ID é o nome do assembly do suplemento.

Registrando adendos para o usuário atual CONTRA. todos os usuários

Quando um suplemento é instalado, pode ser registrado em duas maneiras:

Para o usuário atual apenas (isto é, está disponível apenas para o usuário que está registrado em log no computador quando o suplemento está instalado.)Nesse caso, as entradas de Registro são criadas sob o HKEY_CURRENT_USER.
Para todos os usuários (ou seja, qualquer usuário que registrar o computador pode usar o suplemento).Nesse caso, as entradas de Registro são criadas sob HKEY_LOCAL_MACHINE.

Qualquer suplementos que você cria usando Visual Studio 2012 pode ser registrado para o usuário atual.No entanto, suplementos pode ser registrado para todos os usuários apenas em determinadas situações.Esses cenários dependem da versão do Microsoft Office no computador e como o suplemento foi implantado.

Versão do Microsoft Office

Os aplicativos do Microsoft Office 2010 e Microsoft Office 2013 podem carregar suplementos que são registrados em HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER.

Para carregar suplementos que são registrados em HKEY_LOCAL_MACHINE, os computadores devem ter o pacote de atualização 976477 instalado.Para obter mais informações, https://go.microsoft.com/fwlink/?LinkId=184923consulte.

Tipo de implantação

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

Entradas do Registro

As entradas de Registro do suplemento necessários estão localizadas na chave do Registro a seguir para todos os aplicativos Visio, exceto onde Raiz é HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE.

Raiz\Software\Microsoft\Office\nome do aplicativo\Addins\identificação do suplemento

Para Visio, as entradas do Registro sob pertencem a chave de Registro a seguir.

Raiz\ software \ Microsoft \ \ \ Visio suplementosidentificação do suplemento

A tabela a seguir lista as entradas nessa chave do Registro.

Entrada	Tipo	Valor
Description	REG_SZ	Obrigatório.Uma breve descrição do suplemento. Esta descrição é exibida quando o usuário seleciona o suplemento no painel de Suplementos da caixa de diálogo Opções no aplicativo do Microsoft Office.
FriendlyName	REG_SZ	Obrigatório.Um nome descritivo do suplemento que é exibido na caixa de diálogo Suplementos de COM no aplicativo do Microsoft Office.O valor padrão é a identificação do suplemento
LoadBehavior	REG_DWORD	Obrigatório.Um valor que especifica quando o aplicativo tenta carregar do suplemento e o estado atual do suplemento (carregado ou descarregado). Por padrão, essa entrada é definida como 3, que especifica que o suplemento é carregado na inicialização.Para obter mais informações, consulte Valores de LoadBehavior.
Manifest	REG_SZ	Obrigatório.O caminho completo de manifesto de implantação do suplemento.O caminho pode ser um local no computador local, em um compartilhamento de rede (UNC), ou em um servidor Web (HTTP). Se você usar Windows Installer para implantar a solução, você deve adicionar o prefixo file:/// para o caminho de manifesto .Você também deve acrescentar a cadeia de caracteres \|vstolocal (isto é, o caractere de barra vertical\|seguido por vstolocal) ao final deste caminho.Isso garante que sua solução é carregada a pasta de instalação, em vez do cache de ClickOnce.Para obter mais informações, consulte Implantando uma solução do Office usando o Windows Installer. Observação Quando você cria um suplemento no computador de desenvolvimento, o Visual Studio adiciona automaticamente a cadeia de caracteres de \|vstolocal à entrada do Registro.
Warmup	REG_DWORD	Opcional.Um valor que indica a carga do.NET Framework e de Visual Studio Tools for Office Runtime antes de um suplemento ao carregar e reduz o tempo percebidos de carregar um suplemento.Defina a entrada de Warmup a 1, e usá-lo em conjunto com a entrada de LoadBehavior para reduzir o tempo de carregamento para Outlook 2010 e suplementos de Outlook 2013 que é implantado usando o Windows Installer (.msi).Essa chave do Registro não pode ser definida usando o ClickOnce.

Entradas do Registro para regiões do Outlook

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

Raiz\ software \ Microsoft Outlook Office \ \ \ \ FormRegionsclasse de mensagem

Como outras entradas do Registro compartilhadas por qualquer suplementos, o Visual Studio cria entradas de Registro da região do formulário no computador de desenvolvimento quando você compila seu projeto.Se você usar o ClickOnce para implantar seu suplemento, as entradas de Registro são criados automaticamente no computador do usuário final.Se você usar Windows Installer para implantar seu suplemento, você deve configurar o projeto de edição limitada de InstallShield criar as entradas do Registro no computador do usuário final.

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

Valores de LoadBehavior

A entrada de LoadBehavior em Raiz\ software \ Microsoft \ Office \nome do aplicativo\ \ suplementos chave deidentificação do suplemento contém uma combinação bit a bit de valores que especificam o comportamento em tempo de execução do suplemento.O menor bits do pedido (valores 0 e 1) indica se o suplemento está atualmente descarregado ou carregado.Outros bit indicam quando o aplicativo tenta carregar o suplemento.

Normalmente, a entrada de LoadBehavior destina-se a ser definida como 0, 3, ou 16 (em decimal) quando o suplemento é instalado em computadores de usuário final.Por padrão, o Visual Studio define a entrada de LoadBehavior do suplemento a 3 quando você o cria ou publicar.

A tabela a seguir lista todos os possíveis valores de entrada de LoadBehavior .Algumas descrições nesta tabela a carregar um suplemento manualmente ou por meio de programação.Para carregar manualmente um suplemento, selecione a caixa de seleção ao lado do suplemento na caixa de diálogo Suplementos de COM o aplicativo.Para carregar programaticamente um suplemento, defina a propriedade de Connect do objeto de COMAddIn que representa o suplemento a true.

Avalie (em decimal)	Status do suplemento	Comportamento de carregamento do suplemento	Descrição
0	Descarregado	Não carregar automaticamente	O aplicativo nunca tenta carregar automaticamente o suplemento.O usuário pode tentar carregar manualmente o suplemento, ou o suplemento pode ser carregado por meio de programação. Se o suplemento é carregada com êxito, o valor de LoadBehavior permanece 0, mas o status do suplemento na caixa de diálogo Suplementos de COM COM é atualizado para indicar que o suplemento é carregado.
1	Carregado	Não carregar automaticamente	O aplicativo nunca tenta carregar automaticamente o suplemento.O usuário pode tentar carregar manualmente o suplemento, ou o suplemento pode ser carregado por meio de programação. Embora a caixa de diálogo Suplementos de COM indica que o suplemento é carregado depois que o aplicativo for iniciado, o suplemento não são carregados realmente até que é carregado manualmente ou por meio de programação. Se o aplicativo carrega com êxito o suplemento, o valor de LoadBehavior alterações a 0, e o em 0 após o aplicativo fechar.
2	Descarregado	Carga na inicialização	O aplicativo não tenta carregar automaticamente o suplemento.O usuário pode tentar carregar manualmente o suplemento, ou o suplemento pode ser carregado por meio de programação. Se o aplicativo carrega com êxito o suplemento, o valor de LoadBehavior alterações a 3, e o em 3 após o aplicativo fechar.
3	Carregado	Carga na inicialização	O aplicativo tentar carregar o suplemento quando o aplicativo inicia.Este é o valor padrão quando você cria ou publica um suplemento no Visual Studio. Se o aplicativo carrega com êxito o suplemento, o valor de LoadBehavior permanece 3.Se ocorrer um erro ao carregar o suplemento, o valor de LoadBehavior alterações a 2, e o em 2 após o aplicativo fechar.
8	Descarregado	Carregando sob demanda	O aplicativo não tenta carregar automaticamente o suplemento.O usuário pode tentar carregar manualmente o suplemento, ou o suplemento pode ser carregado por meio de programação. Se o aplicativo carrega com êxito o suplemento, o valor de LoadBehavior muda para 9.
9	Carregado	Carregando sob demanda	O suplemento será carregado somente quando o aplicativo requer, como quando um usuário clica em um elemento de interface do usuário que use a funcionalidade no suplemento (por exemplo, um botão personalizado em fita). Se o aplicativo carrega com êxito o suplemento, o valor de LoadBehavior permanece 9, mas o status do suplemento na caixa de diálogo Suplementos de COM COM é atualizado para indicar que o suplemento é carregado no momento.Se ocorrer um erro ao carregar o suplemento, o valor de LoadBehavior muda para 8.
16	Carregado	Carregar a primeira vez, então carregar sob demanda	Definir esse valor se você desejar que o suplemento para ser carregado sob demanda.O aplicativo carrega o suplemento ao usuário executa o aplicativo pela primeira vez.Na próxima vez que o usuário executa o aplicativo, o aplicativo carrega todos os elementos de interface do usuário que são definidos pelo suplemento, mas o suplemento não é carregado até que o usuário clique em um elemento de interface do usuário que está associado com o suplemento. Quando o aplicativo for carregado com êxito o suplemento pela primeira vez, o valor de LoadBehavior permanece 16 quando o suplemento é carregado.Depois que o aplicativo fecha, o valor de LoadBehavior muda para 9.