Entradas de registro para Application-Nível Adicionar-ins

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Versão do Microsoft Office Microsoft Office Sistema de 2007 Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de aplicativo

Versão do Microsoft Office

Microsoft Office Sistema de 2007
Microsoft Office 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você deve criar um conjunto específico de entradas do Registro quando você implanta Adicionar-ins que são criados usando Ferramentas do Visual Studio para o Office.Essas entradas do registro fornecem informações que habilita o aplicativo do Microsoft Office descobrir e carregar o Adicionar - in.For more information, see Arquitetura de nível de aplicativo Adicionar-ins.

Quando você Compilação seu projeto, Ferramentas do Visual Studio para o Office cria essas entradas do Registro no computador de desenvolvimento para que você pode depurar com facilidade o Adicionar-in.For more information, see Office solução Compilação processo Visão geral.

Para obter informações sobre como criar as chaves do registro do usuário final computadores quando você Implantar o Adicionar-in, consulte Implantando soluções do Office (Sistema de 2007) e Implantando o nível de aplicativo Adicionar-ins (sistema de 2003).

Neste tópico, o texto suplemento ID representa uma Exclusivo identificação para o Adicionar-in.Por padrão, a identificação é o nome do projeto Adicionar-in.

Entradas de registro para o 2007 Microsoft Office Sistema

O necessário Adicionar - em entradas do Registro para o 2007 Microsoft Office sistema estão localizados sob a seguinte chave de registro para Tudo aplicativos exceto o Microsoft Office Visio:

HKEY_CURRENT_USER\Software\Microsoft\Office\ Nome do aplicativo\Addins\suplemento ID

Para o Visio, as entradas do Registro pertencem na seguinte chave do Registro:

HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ suplemento ID

Observação:
Aplicativos no 2007 Microsoft Office Sistema somente reconhecer Ferramentas do Visual Studio para o Office Adicionar-ins que estão registrados em HKEY_CURRENT_USER.Isso significa que você não é possível implantar um Ferramentas do Visual Studio para o Office Adicionar - in para o 2007 Microsoft Office Sistema para Tudo usuários um computador ao registrar o Adicionar - in em HKEY_LOCAL_MACHINE.

Aplicativos no 2007 Microsoft Office Sistema somente reconhecer Ferramentas do Visual Studio para o Office Adicionar-ins que estão registrados em HKEY_CURRENT_USER.Isso significa que você não é possível implantar um Ferramentas do Visual Studio para o Office Adicionar - in para o 2007 Microsoft Office Sistema para Tudo usuários um computador ao registrar o Adicionar - in em HKEY_LOCAL_MACHINE.

A tabela a seguir lista as entradas que são necessárias sob esta chave de registro.

Entrada	Type (Tipo)	Value (Valor)
Description	REG_SZ	Uma breve descrição do Adicionar - in. Essa descrição é exibida quando o usuário seleciona o Adicionar-in no painel de Adicionar-ins do caixa de diálogo Opções no aplicativo do Microsoft Office.
FriendlyName	REG_SZ	Um nome descritivo do Adicionar-in que é exibido na caixa de diálogo de suplementos de COM no aplicativo do Microsoft Office.O valor padrão é a identificação do Adicionar-in.
LoadBehavior	REG_DWORD	Um valor que especifica quando o aplicativo tenta carregar o suplemento e o estado atual do Adicionar-in (carregado ou descarregado). Por padrão, essa entrada é definida como 3, que especifica que o Adicionar - in é carregado na inicialização.Para obter mais informações, consulte valores LoadBehavior.
Manifest	REG_SZ	O caminho completo do manifesto da implantação para o Adicionar - in.O caminho pode ser um local no computador local, um Compartilhar de rede (UNC), ou um servidor Web (HTTP). Observação: Quando você Compilação um Adicionar-in no computador de desenvolvimento, Ferramentas do Visual Studio para o Office acrescenta a Cadeia de Caracteres \|vstolocal (ou seja, o pipe caractere \| seguido de vstolocal ) para esta entrada do Registro.Isso ajuda a Ferramentas do Visual Studio para o Office carregar o Adicionar-in quando você executa-lo do Visual Studio em um computador de desenvolvimento.

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

Se você criar uma região de formulário Personalizar em um Adicionar-in para o Microsoft Office Outlook 2007, uma entrada de registro é usada para registrar a região de formulário com o Outlook.Essa entrada do Registro está localizada na seguinte chave:

Classe de mensagem do HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions\

Para obter mais informações, consulte regiões de formulário especificando no Registro do Windows.Para obter mais informações sobre regiões de formulário do Outlook, consulte Criar regiões de formulário do Outlook.

Entradas de registro para o Microsoft Office 2003

O necessário Adicionar no Registro entradas para o Microsoft Office 2003 estão localizadas nas seguintes chaves do Registro:

HKEY_CURRENT_USER\Software\Microsoft\Office\ Nome do aplicativo\Addins\suplemento ID
HKEY_CURRENT_USER\Software\Classes\ Adicionar - ID \CLSID
HKEY_CURRENT_USER\Software\Classes\CLSID\ {Adicionar - CLSID}
HKEY_CURRENT_USER\Software\Classes\CLSID\ {Adicionar - CLSID} \InprocServer32
HKEY_CURRENT_USER\Software\Classes\CLSID\ {Adicionar - CLSID} \ProgID
HKEY_CURRENT_USER\Software\Classes\CLSID\ {Adicionar - CLSID} \Programmable
HKEY_CURRENT_USER\Software\Classes\CLSID\ {Adicionar - CLSID} \VersionIndependentProgID

Observação:
Você pode fazer uma Ferramentas do Visual Studio para o Office Adicionar - in para o Microsoft Office 2003 disponível para Tudo usuários em um computador criando as chaves do Registro em HKEY_LOCAL_MACHINE em vez de HKEY_CURRENT_USER.

As seções a seguintes lista as entradas que são necessárias sob cada chave de registro.O texto Adicionar-no CLSID representa o identificador de classe globalmente exclusivo (CLSID) do seu Adicionar - in.Para obter o CLSID do seu Adicionar - in, você pode se referir a um dos seguintes locais:

O valor padrão da adição de HKEY_CURRENT_USER\Software\Classes\ - ID \CLSID registro entrada criada no seu computador de desenvolvimento quando você Compilação o Adicionar-in.
O elemento de ProjectGuid no .csproj (para C#) ou arquivos de projeto .vbproj (para Visual Basic).

Observação:
Você deve criar algumas das entradas do Registro na seguinte lista de uma subárvore diferente se você estiver implantando um Microsoft Office 2003 Adicionar - in para o Windows Vista.Para obter mais informações, consulte Entradas de registro para Microsoft Office 2003 Adicionar-ins no Windows Vista.

\Addins\ HKEY_CURRENT_USER\Software\Microsoft\Office\ < nome do aplicativo > < suplemento ID >

Observação:
Para o Visio Adicionar-ins, Use o seguinte chave: HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ Adicionar-na ID.

Entrada	Type (Tipo)	Value (Valor)
Description	REG_SZ	Uma breve descrição do Adicionar - in.
FriendlyName	REG_SZ	Um nome descritivo do Adicionar-in que é exibido na caixa de diálogo de suplementos de COM no aplicativo do Microsoft Office.O valor padrão é a identificação do Adicionar-in.
LoadBehavior	REG_DWORD	Um valor que especifica quando o aplicativo tenta carregar o suplemento e o estado atual do Adicionar-in (carregado ou descarregado). Por padrão, essa entrada é definida como 3, que especifica que o Adicionar - in é carregado na inicialização.Para obter mais informações, consulte valores LoadBehavior.
Manifest	REG_SZ	O caminho completo do manifesto do aplicativo para o Adicionar - in.Isso deve ser uma pasta local no computador cliente.

IDENTIFICAÇÃO de HKEY_CURRENT_USER\Software\Classes\Adicionar-in

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ	A descrição do Adicionar - in.

ID\CLSID HKEY_CURRENT_USER\Software\Classes\Adicionar-in

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ	O identificador de classe globalmente exclusivo (CLSID) do Adicionar - in.

HKEY_CURRENT_USER\Software\Classes\CLSID\ {< Adicionar - CLSID >}

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ	A descrição do Adicionar - in.

HKEY_CURRENT_USER\Software\Classes\CLSID\ {< Adicionar - CLSID >} \InprocServer32

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ - ou - REG_EXPAND_SZ	O caminho completo do carregador Ferramentas do Visual Studio para o Office no computador que está executando o Adicionar-in.Essa entrada sempre deve ser definida como %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll. Para obter mais informações sobre o carregador de Ferramentas do Visual Studio para o Office , consulte O Visual Studio Tools for Visão geral de tempo de execução do Office. Observação: Se você usar uma variável de ambiente no caminho, use o tipo de REG_EXPAND_SZ para essa entrada.Caso contrário, use o tipo REG_SZ.
ManifestLocation	REG_SZ	O caminho de manifesto do aplicativo para o Adicionar - in.Isso deve ser uma pasta local no computador cliente.
ManifestName	REG_SZ	O nome do manifesto do aplicativo para o Adicionar - in.
ThreadingModel	REG_SZ	O modelo de segmentação.Essa entrada deve ser definida como Ambos.

HKEY_CURRENT_USER\Software\Classes\CLSID\ {< Adicionar - CLSID >} \ProgID

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ	A Exclusivo identificação do Adicionar-in.

HKEY_CURRENT_USER\Software\Classes\CLSID\ {< Adicionar - CLSID >} \Programmable

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ	Fazer Não Definido um valor para essa entrada.

HKEY_CURRENT_USER\Software\Classes\CLSID\ {< Adicionar - CLSID >} \VersionIndependentProgID

Entrada	Type (Tipo)	Value (Valor)
(Default)	REG_SZ	A versão independente Exclusivo identificação do Adicionar-in.

Entradas de registro para Microsoft Office 2003 Adicionar-ins no Windows Vista

Se você estiver implantando um Microsoft Office 2003 Adicionar - in em um computador que está executando o Windows Vista, você deve criar várias das chaves do Registro em uma subárvore do Registro diferente nas seguintes situações:

O usuário está executando o aplicativo do Microsoft Office 2003 com um token de Acessar de administrador completo.

- ou -
O usuário tiver ativado desativar Controlarar de conta de usuário (UAC).

Nessas situações, você deve criar as chaves de Registro do COM (isto é, para Tudos das chaves que são definidas em HKEY_CURRENT_USER\Software\Classes) em HKEY_LOCAL_MACHINE\Software\Classes em vez disso.

Você deve usar a subárvore máquina porque Windows Vista procura COM chaves de registro somente sob HKEY_LOCAL_MACHINE nesses cenários.Para obter informações sobre como alterar as chaves do Registro no projeto de instalação padrão, consulte Instalação projetos para o nível de aplicativo Adicionar-ins (sistema de 2003).

Observação:
Não Mover as chaves do Registro que estão sob HKEY_CURRENT_USER\Software\Microsoft nesses cenários.

Valores de LoadBehavior

A entrada LoadBehavior sob o HKEY_CURRENT_USER\Software\Microsoft\Office\Nome do aplicativo\Addins\add-in identificação chave contém um valor que especifica quando o aplicativo tenta carregar o suplemento e o estado atual do add - in (carregado ou descarregado).Por padrão, essa entrada é definida como 3 quando você Compilação ou implantar seu Adicionar - in.

A tabela a seguir lista os possíveis valores da entrada LoadBehavior.

Valor (em decimal)	Significado do valor	Descrição
0	Unloaded	O aplicativo não tenta carregar o Adicionar - quando o aplicativo for iniciado.O usuário pode tentar carregar manualmente o Adicionar - in usando COM Adicionar-caixa de diálogo de ins no aplicativo.
1	Loaded	O aplicativo não tenta carregar o Adicionar - quando o aplicativo for iniciado.O usuário pode tentar carregar manualmente o Adicionar - in usando COM Adicionar-caixa de diálogo de ins no aplicativo.
2	Carregar na inicialização \| Unloaded	O aplicativo tenta carregar o Adicionar - quando o aplicativo for iniciado. Se o aplicativo for carregado com êxito o Adicionar-in, o valor de LoadBehavior altera para 3.
3	Carregar na inicialização \| carregado	O aplicativo tenta carregar o Adicionar - quando o aplicativo for iniciado. Se o aplicativo for carregado com êxito o Adicionar-in, o valor de LoadBehavior permanece 3.Se ocorrer um erro ao Carregando o Adicionar - in, as alterações de valor LoadBehavior 2.
8	Carga na demanda \| Unloaded	O aplicativo tenta carregar o suplemento somente quando o aplicativo requer, como quando um usuário clica em um elemento de interface do usuário que usa a funcionalidade no Adicionar-in. Se o aplicativo for carregado com êxito o Adicionar-in, o valor de LoadBehavior altera para 9.
9	Carga na demanda \| carregado	O aplicativo tenta carregar o suplemento somente quando o aplicativo requer, como quando um usuário clica em um elemento de interface do usuário que usa a funcionalidade no Adicionar-in. Se o aplicativo for carregado com êxito o Adicionar-in, o valor de LoadBehavior permanece 9.Se ocorrer um erro ao Carregando o Adicionar - in, as alterações de valor LoadBehavior 8.
16	Carregar na Primeiro inicialização	As cargas de aplicativo a Adicionar - quando o usuário executa o aplicativo pela Primeiro vez.A Avançar vez que o aplicativo for iniciado, o aplicativo carrega todos os elementos da interface do usuário que são definidos pelo Adicionar-in, mas o Adicionar-in não está carregado até que o usuário clique em um elemento de interface do usuário que está associado com o Adicionar-in. Se o aplicativo for carregado com êxito o Adicionar - na Avançar vez que o aplicativo for iniciado, as alterações de valor LoadBehavior 9.