Entrées du Registre pour les compléments d'application

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau de l'application Version de Microsoft Office Version 2007 de Microsoft Office System Microsoft Office 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau de l'application

Version de Microsoft Office

Version 2007 de Microsoft Office System
Microsoft Office 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous devez créer un jeu spécifique d'entrées du Registre lorsque vous déployez des compléments créés en utilisant Visual Studio Tools pour Office. Ces entrées du Registre fournissent des informations qui permettent à l'application Microsoft Office de découvrir et charger le complément. Pour plus d'informations, consultez Architecture des compléments d'application.

Lorsque vous générez votre projet, Visual Studio Tools pour Office crée ces entrées du Registre sur l'ordinateur de développement afin que vous puissiez déboguer le complément facilement. Pour plus d'informations, consultez Vue d'ensemble du processus de génération de solutions Office.

Pour plus d'informations sur la création des clés de Registre sur les ordinateurs des utilisateurs finaux lorsque vous déployez le complément, consultez Déploiement de solutions Office (Office System 2007) et Déploiement de compléments d'application (Office System 2003).

Dans cette rubrique, le texte ID du complément représente un ID unique pour votre complément. Par défaut, l'ID est le nom du projet de complément.

Entrées du Registre pour la version 2007 de Microsoft Office System

Les entrées du Registre requises pour les compléments pour la version 2007 de Microsoft Office System se trouvent sous la clé de Registre suivante pour toutes les applications à l'exception de Microsoft Office Visio :

HKEY_CURRENT_USER\Software\Microsoft\Office\nom de l'application\Addins\ID du complément

Pour Visio, les entrées du Registre se trouvent sous la clé de Registre suivante :

HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ID du complément

Remarque :
Les applications de la version 2007 de Microsoft Office System ne reconnaissent que les compléments Visual Studio Tools pour Office enregistrés sous HKEY_CURRENT_USER. Cela signifie que vous ne pouvez pas déployer de complément Visual Studio Tools pour Office pour la version 2007 de Microsoft Office System chez tous les utilisateurs sur un ordinateur en enregistrant le complément sous HKEY_LOCAL_MACHINE.

Les applications de la version 2007 de Microsoft Office System ne reconnaissent que les compléments Visual Studio Tools pour Office enregistrés sous HKEY_CURRENT_USER. Cela signifie que vous ne pouvez pas déployer de complément Visual Studio Tools pour Office pour la version 2007 de Microsoft Office System chez tous les utilisateurs sur un ordinateur en enregistrant le complément sous HKEY_LOCAL_MACHINE.

Le tableau suivant répertorie les entrées requises sous cette clé de Registre.

Entrée	Type	Valeur
Description	REG_SZ	Brève description du complément. Cette description est affichée lorsque l'utilisateur sélectionne le complément dans le volet Compléments de la boîte de dialogue Options dans l'application Microsoft Office.
FriendlyName	REG_SZ	Nom descriptif du complément affiché dans la boîte de dialogue Compléments COM dans l'application Microsoft Office. La valeur par défaut est l'ID du complément.
LoadBehavior	REG_DWORD	Une valeur qui spécifie quand l'application essaie de charger le complément et l'état actuel du complément (chargé ou non chargé). Par défaut, cette entrée a la valeur 3, laquelle indique que le complément est chargé au démarrage. Pour plus d'informations, consultez Valeurs LoadBehavior.
Manifest	REG_SZ	Chemin d'accès complet du manifeste de déploiement pour le complément. Le chemin d'accès peut être un emplacement sur l'ordinateur local, un partage réseau (UNC) ou un serveur Web (HTTP). Remarque : Lorsque vous générez un complément sur l'ordinateur de développement, Visual Studio Tools pour Office ajoute la chaîne \| vstolocal (autrement dit, le symbole de canal \| suivi de vstolocal) à cette entrée du Registre. Cela aide Visual Studio Tools pour Office à charger le complément lorsque vous l'exécutez sur l'ordinateur de développement à partir de Visual Studio.

Entrées de Registre pour des zones de formulaire Outlook

Si vous créez une zone de formulaire personnalisée dans un complément pour Microsoft Office Outlook 2007, une entrée de Registre est utilisée pour enregistrer la zone de formulaire avec Outlook. Cette entrée du Registre se trouve sous la clé suivante :

HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions \classe de message

Pour plus d'informations, consultez Spécification des zones du formulaire dans le Registre Windows. Pour plus d'informations sur les zones de formulaire Outlook, consultez Création de zones de formulaire Outlook.

Entrées du Registre pour Microsoft Office 2003

Les entrées du Registre requises pour les compléments pour Microsoft Office 2003 se trouvent sous les clés de Registre suivante :

HKEY_CURRENT_USER\Software\Microsoft\Office\nom de l'application\Addins\ID du complément
HKEY_CURRENT_USER\Software\Classes\ID du complément\CLSID
HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID du complément}
HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID du complément}\InprocServer32
HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID du complément}\ProgID
HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID du complément}\Programmable
HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID du complément}\VersionIndependentProgID

Remarque :
Vous pouvez assurer la disponibilité d'un complément Visual Studio Tools pour Office pour Microsoft Office 2003 à tous les utilisateurs sur un ordinateur en créant les clés de Registre sous HKEY_LOCAL_MACHINE au lieu de HKEY_CURRENT_USER.

Les sections suivantes répertorient les entrées requises sous chaque clé de Registre. Le texte CLSID du complément représente l'identificateur de classe globalement unique (CLSID) de votre complément. Pour obtenir le CLSID de votre complément, vous pouvez faire référence à l'un des emplacements suivants :

La valeur par défaut de l'entrée de Registre HKEY_CURRENT_USER\Software\Classes\ID du complément\CLSID créée sur votre ordinateur de développement lorsque vous générez le complément.
L'élément ProjectGuid dans les fichiers projet .csproj (pour C#) ou .vbproj (pour Visual Basic).

Remarque :
Vous devez créer quelques-unes des entrées du Registre dans la liste suivante dans une sous-arborescence différente si vous déployez un complément Microsoft Office 2003 sur Windows Vista. Pour plus d'informations, consultez Entrées du Registre pour les Compléments Microsoft Office 2003 sur Windows Vista.

HKEY_CURRENT_USER\Software\Microsoft\Office\<nom de l'application>\Addins\<ID du complément>

Remarque :
Pour les compléments Visio, utilisez la clé suivante : HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ID du complément

Entrée	Type	Valeur
Description	REG_SZ	Brève description du complément.
FriendlyName	REG_SZ	Nom descriptif du complément affiché dans la boîte de dialogue Compléments COM dans l'application Microsoft Office. La valeur par défaut est l'ID du complément.
LoadBehavior	REG_DWORD	Une valeur qui spécifie quand l'application essaie de charger le complément et l'état actuel du complément (chargé ou non chargé). Par défaut, cette entrée a la valeur 3, laquelle indique que le complément est chargé au démarrage. Pour plus d'informations, consultez Valeurs LoadBehavior.
Manifest	REG_SZ	Chemin d'accès complet du manifeste d'application pour le complément. Il doit s'agir d'un dossier local sur l'ordinateur client.

HKEY_CURRENT_USER\Software\Classes\ID du complément

Entrée	Type	Valeur
(Default)	REG_SZ	Description du complément.

HKEY_CURRENT_USER\Software\Classes\ID du complément\CLSID

Entrée	Type	Valeur
(Default)	REG_SZ	Identificateur global unique de classe (CLSID) du complément.

HKEY_CURRENT_USER\Software\Classes\CLSID \{< CLSID du complément>}

Entrée	Type	Valeur
(Default)	REG_SZ	Description du complément.

HKEY_CURRENT_USER\Software\Classes\CLSID \{<CLSID du complément>} \InprocServer32

Entrée	Type	Valeur
(Default)	REG_SZ - ou - REG_EXPAND_SZ	Le chemin d'accès complet du chargeur Visual Studio Tools pour Office sur l'ordinateur qui exécute le complément. Cette entrée doit toujours avoir la valeur %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll. Pour plus d'informations sur le chargeur Visual Studio Tools pour Office, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime. Remarque : Si vous utilisez une variable d'environnement dans le chemin d'accès, utilisez le type REG_EXPAND_SZ pour cette entrée. Sinon, utilisez le type REG_SZ.
ManifestLocation	REG_SZ	Le chemin d'accès du manifeste d'application pour le complément. Il doit s'agir d'un dossier local sur l'ordinateur client.
ManifestName	REG_SZ	Nom du manifeste d'application pour le complément.
ThreadingModel	REG_SZ	Modèle de thread. Cette entrée doit avoir pour valeur Both.

HKEY_CURRENT_USER\Software\Classes\CLSID \{<CLSID du complément>} \ProgID

Entrée	Type	Valeur
(Default)	REG_SZ	ID unique du complément.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID du complément>}\Programmable

Entrée	Type	Valeur
(Default)	REG_SZ	Ne définissez pas de valeur pour cette entrée.

HKEY_CURRENT_USER\Software\Classes\CLSID \{<CLSID du complément>}\VersionIndependentProgID

Entrée	Type	Valeur
(Default)	REG_SZ	ID unique indépendant de la version du complément.

Entrées du Registre pour les compléments Microsoft Office 2003 sur Windows Vista

Si vous déployez un complément Microsoft Office 2003 sur un ordinateur exécutant Windows Vista, vous devez créer plusieurs des clés de Registre dans une sous-arborescence de Registre différente dans les scénarios suivants :

L'utilisateur exécute l'application Microsoft Office 2003 avec un jeton d'accès d'administrateur complet.

- ou -
L'utilisateur a désactivé l'UAC (User Account Control, contrôle de compte d'utilisateur).

Dans ces scénarios, vous devez créer les clés d'inscription COM (c'est-à-dire, toutes les clés définies sous HKEY_CURRENT_USER\Software\Classes) au lieu de HKEY_LOCAL_MACHINE\Software\Classes.

Vous devez utiliser la sous-arborescence Machine parce que Windows Vista recherche les clés d'inscription COM uniquement sous HKEY_LOCAL_MACHINE dans ces scénarios. Pour plus d'informations sur la modification des clés de Registre dans le projet d'installation par défaut, consultez Projets d'installation pour les compléments d'application (Office System 2003).

Remarque :
Ne déplacez pas les clés de Registre qui sont sous HKEY_CURRENT_USER\Software\Microsoft dans ces scénarios.

Valeurs LoadBehavior

L'entrée LoadBehavior sous la clé HKEY_CURRENT_USER\Software\Microsoft\Office\nom application\Addins\ID complément contient une valeur qui spécifie le moment auquel l'application tente de charger le complément et l'état actuel du complément (chargé ou déchargé). Par défaut, cette entrée a la valeur 3 lorsque vous générez ou déployez votre complément.

Le tableau suivant énumère les valeurs possibles de l'entrée LoadBehavior.

Valeur (en décimal)	Signification de la valeur	Description
0	Déchargé	L'application ne tente pas de charger le complément lorsque l'application démarre. L'utilisateur peut essayer de charger manuellement le complément en utilisant la boîte de dialogue Compléments COM dans l'application.
1	Chargé	L'application ne tente pas de charger le complément lorsque l'application démarre. L'utilisateur peut essayer de charger manuellement le complément en utilisant la boîte de dialogue Compléments COM dans l'application.
2	Charger au démarrage \| Déchargé	L'application essaie de charger le complément lorsque l'application démarre. Si l'application charge le complément avec succès, la valeur LoadBehavior passe à 3.
3	Charger au démarrage \| Chargé	L'application essaie de charger le complément lorsque l'application démarre. Si l'application charge correctement le complément, la valeur LoadBehavior demeure 3. Si une erreur se produit lors du chargement du complément, la valeur LoadBehavior passe à 2.
8	Charger à la demande \| Déchargé	L'application essaie de charger le complément uniquement lorsque l'application le requiert, par exemple lorsqu'un utilisateur clique sur un élément de l'interface utilisateur qui utilise les fonctionnalités dans le complément. Si l'application charge le complément avec succès, la valeur LoadBehavior passe à 9.
9	Charger à la demande \| Chargé	L'application essaie de charger le complément uniquement lorsque l'application le requiert, par exemple lorsqu'un utilisateur clique sur un élément de l'interface utilisateur qui utilise les fonctionnalités dans le complément. Si l'application charge le complément avec succès, la valeur LoadBehavior demeure 9. Si une erreur se produit lors du chargement du complément, la valeur LoadBehavior passe à 8.
16	Charger au premier démarrage	L'application charge le complément lorsque l'utilisateur lance l'application pour la première fois. Lors du prochain démarrage de l'application, celle-ci charge tous les éléments de l'interface utilisateur définis par le complément, mais celui-ci n'est pas chargé tant que l'utilisateur ne clique pas sur un élément de l'interface utilisateur associé au complément. Si l'application charge avec succès le complément lors du prochain démarrage de l'application, la valeur LoadBehavior passe à 9.