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

Article
03/04/2013

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 2012.Ces entrées du Registre fournissent des informations qui permettent à l'application Microsoft Office de découvrir et charger le complément.

**S'applique à :**Les informations contenues dans cette rubrique s'appliquent aux projets de niveau application pour Microsoft Office 2013 Preview et Microsoft Office 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Lorsque vous générez votre projet, Visual Studio crée ces entrées du Registre sur l'ordinateur de développement afin que vous puissiez exécuter et déboguer facilement le complément.Si vous utilisez ClickOnce pour déployer votre complément, les entrées du Registre sont créées automatiquement sur l'ordinateur de l'utilisateur final.Si vous utilisez windows installer pour déployer votre complément, vous devez configurer le projet d'édition d'InstallShield Limited pour créer des entrées du Registre sur l'ordinateur de l'utilisateur final.

Pour plus d'informations sur la façon dont les entrées du Registre sont utilisées pendant le processus de chargement des compléments, consultez Architecture des compléments d'application.

[!REMARQUE]

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 de votre assembly de complément.

Stocker les compléments pour l'utilisateur actuel VS. tous les utilisateurs

Lorsqu'un complément est installé, il peut être inscrit de deux façons :

Pour l'utilisateur actuel uniquement (autrement dit, il est disponible uniquement pour l'utilisateur qui est connecté à l'ordinateur lorsque le complément est installé).Dans ce cas, les entrées du Registre sont créées sous HKEY_CURRENT_USER.
Pour tous les utilisateurs (c'est-à-dire tout utilisateur qui se connecte à l'ordinateur peut utiliser le complément).Dans ce cas, les entrées du Registre sont créées sous HKEY_LOCAL_MACHINE.

Tous les compléments que vous créez à l'aide de Visual Studio 2012 peuvent être inscrits pour l'utilisateur actuel.Toutefois, les compléments peuvent être enregistrés pour tous les utilisateurs dans certains scénarios.Ces scénarios dépendent de la version de Microsoft Office installée sur l'ordinateur et de la manière dont le complément a été déployé.

Version de Microsoft Office

Les applications Microsoft Office 2010 et Microsoft Office 2013 peuvent charger des compléments qui sont stockées sous HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER.

Pour charger des compléments qui sont stockés sous HKEY_LOCAL_MACHINE, les ordinateurs doivent avoir la mise à jour installée 976477.Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=184923.

Type de déploiement

Si vous utilisez ClickOnce pour déployer un complément, celui-ci peut être inscrit uniquement pour l'utilisateur actuel.Cela est dû au fait que ClickOnce ne prend en charge que la création des clés sous HKEY_CURRENT_USER.Si vous souhaitez enregistrer un complément pour tous les utilisateurs d'un ordinateur, vous devez utiliser Windows Installer pour déployer le complément.Pour plus d'informations sur ces types de déploiement, consultez Déploiement d'une solution Office à l'aide de ClickOnce et Déploiement d'une solution Office à l'aide de Windows Installer.

Entrées du Registre

Les entrées du Registre de complément requises sont situées sous la clé de Registre suivante pour toutes les applications, à l'exception de Visio, où Root est HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE.

Root\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.

Root\software\Microsoft\Visio\Addins\ID de l'add-in

La table suivante répertorie les entrées sous cette clé de Registre.

Entry	Type	Valeur
Description	REG_SZ	Requis.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	Requis.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	Requis.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	Requis.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). Si vous utilisez windows installer pour déployer la solution, vous devez ajouter le préfixe file:/// au chemin d' manifeste .Vous devez également ajouter la chaîne \|vstolocal (autrement dit, le caractère de canal\|suivi de vstolocal) à la fin de ce chemin d'accès.Cela garantit que votre solution est chargée à partir du dossier d'installation, plutôt que du cache ClickOnce.Pour plus d'informations, consultez Déploiement d'une solution Office à l'aide de Windows Installer. Remarque Lorsque vous générez un complément sur l'ordinateur de développement, Visual Studio ajoute automatiquement la chaîne \|vstolocal à cette entrée du Registre.
Warmup	REG_DWORD	Optionnel.Une valeur qui indique que l'infrastructure .NET et Visual Studio Tools pour Office Runtime sont chargés avant le chargement d'un complément et réduisent la durée de chargement perçue pour un complément.Définissez Warmup d'entrée à 1, et utilisez-le avec l'entrée d' LoadBehavior pour réduire le temps de chargement pour Outlook 2010 et les compléments d' Outlook 2013 qui sont déployés à l'aide de windows installer (.msi).Cette clé de Registre ne peut pas être définie à l'aide de ClickOnce.

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 Outlook, les entrées du Registre supplémentaires sont utilisées pour enregistrer la zone de formulaire avec Outlook.Ces entrées sont créées sous une clé de Registre différente pour chaque classe de message que la zone de formulaire prend en charge.Ces clés de Registre sont dans l'emplacement suivant, où Racine est HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE.

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

Comme les autres entrées du Registre partagées par tous les compléments, Visual Studio crée les entrées du Registre des zones de formulaire sur l'ordinateur de développement lorsque vous générez votre projet.Si vous utilisez ClickOnce pour déployer votre complément, les entrées du Registre sont créées automatiquement sur l'ordinateur de l'utilisateur final.Si vous utilisez windows installer pour déployer votre complément, vous devez configurer le projet d'édition d'InstallShield Limited pour créer des entrées du Registre sur l'ordinateur de l'utilisateur final.

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

Valeurs LoadBehavior

L'entrée LoadBehavior figurant sous le nom de clé Root\Software\Microsoft\Office\nom de l'application\Addins\ID de complément contient une combinaison binaire de valeurs qui spécifient le comportement au moment de l'exécution du complément.Le bit le moins significatif (valeurs 0 et 1) indique si le complément est en cours de déchargement ou de chargement.Les autres bits indiquent quand l'application tente de charger le complément.

En général, l'entrée LoadBehavior doit avoir la valeur 0, 3, 9 ou 16 (en format décimal) lorsque le complément est installé sur les ordinateurs des utilisateurs finaux.Par défaut, Visual Studio affecte à l'entrée LoadBehavior de votre complément la valeur 3 lorsque vous générez ou le publiez.

Le tableau suivant énumère toutes les valeurs possibles de l'entrée LoadBehavior.Certaines descriptions de cette table font référence au chargement manuel ou par programme d'un complément.Pour charger un complément manuellement, activez la case à cocher en regard du complément dans la boîte de dialogue Compléments COM dans l'application.Pour charger un complément par programmation, affectez à la propriété Connect de l'objet COMAddIn qui représente le complément, la valeur true.

Valeur (en décimal)	État du complément	Comportement de chargement des compléments	Description
0	Unloaded	Ne pas charger automatiquement	L'application n'essaie jamais de charger automatiquement le complément.L'utilisateur peut essayer de charger le complément manuellement, ou le complément peut être chargé par programmation. Si le complément est chargé avec succès, la valeur LoadBehavior reste 0, mais l'état du complément dans la boîte de dialogue Compléments COM est mis à jour pour indiquer que le complément est chargé.
1	Loaded	Ne pas charger automatiquement	L'application n'essaie jamais de charger automatiquement le complément.L'utilisateur peut essayer de charger le complément manuellement, ou le complément peut être chargé par programmation. Bien que la boîte de dialogue Compléments COM indique que le complément est chargé une fois l'application démarrée, le complément n'est pas chargé réellement jusqu'à ce qu'il soit chargé manuellement ou par programmation. Si l'application charge le complément avec succès, la valeur LoadBehavior change en 0, et reste à 0 une fois l'application fermé.
2	Unloaded	Charger au démarrage	L'application n'essaie pas de charger automatiquement le complément.L'utilisateur peut essayer de charger le complément manuellement, ou le complément peut être chargé par programmation. Si l'application charge le complément avec succès, la valeur LoadBehavior est changé en 3, et reste à 3 une fois l'application fermé.
3	Loaded	Charger au démarrage	L'application essaie de charger le complément lorsque l'application démarre.C'est la valeur par défaut lorsque vous générez ou publiez un complément dans Visual Studio. Si l'application charge le complément avec succès, la valeur LoadBehavior reste 3.Si une erreur se produit lors du chargement du complément, la valeur LoadBehavior change en 2, et reste à 2 une fois l'application fermé.
8	Unloaded	Charger à la demande	L'application n'essaie pas de charger automatiquement le complément.L'utilisateur peut essayer de charger le complément manuellement, ou le complément peut être chargé par programmation. Si l'application charge le complément avec succès, la valeur LoadBehavior passe à 9.
9	Loaded	Charger à la demande	Autrement dit, le complément sera chargé uniquement lorsque l'application le requiert, comme dans le cas où un utilisateur clique sur un élément d'interface utilisateur qui fait appel aux fonctionnalités du complément (par exemple, un bouton personnalisé du ruban). Si l'application charge le complément avec succès, la valeur LoadBehavior reste 9, mais l'état du complément dans la boîte de dialogue Compléments COM est mis à jour pour indiquer que le complément est chargé actuellement.Si une erreur se produit lors du chargement du complément, la valeur LoadBehavior change en 8.
16	Loaded	Chargez la première fois, puis chargez à la demande	Définissez cette valeur si vous souhaitez que votre complément soit chargé à la demande.L'application charge le complément lorsque l'utilisateur lance l'application pour la première fois.Lorsque l'utilisateur exécute à nouveau l'application, celle-ci charge tous les éléments d'interface utilisateur définis par le complément, mais le complément n'est pas chargé tant que l'utilisateur ne clique pas sur un élément d'interface utilisateur qui lui est associé. Lorsque l'application charge avec succès le complément pour la première fois, la valeur LoadBehavior reste 16 pendant que le complément est chargé.Après avoir fermé l'application, la valeur LoadBehavior change en 9.