Entrées de Registre pour les Compléments VSTORegistry entries for VSTO Add-ins

Vous devez créer un ensemble spécifique d'entrées de Registre quand vous déployez des compléments VSTO créés à l'aide de Visual Studio.You must create a specific set of registry entries when you deploy VSTO Add-ins that are created by using Visual Studio. Ces entrées de Registre fournissent des informations qui permettent à l'application Microsoft Office de découvrir et de charger le complément VSTO.These registry entries provide information that enables the Microsoft Office application to discover and load the VSTO Add-in.

S’applique à : les informations contenues dans cette rubrique s’applique à VSTO ajouter-dans les projets.Applies to: The information in this topic applies to VSTO Add-in projects. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Quand vous générez votre projet, Visual Studio crée ces entrées de Registre sur l'ordinateur de développement pour que vous puissiez facilement exécuter et déboguer le complément VSTO.When you build your project, Visual Studio creates these registry entries on the development computer so that you can easily run and debug the VSTO Add-in. Si vous utilisez ClickOnce pour déployer votre complément, VSTO, les entrées de Registre sont automatiquement créées sur l’ordinateur de l’utilisateur final.If you use ClickOnce to deploy your VSTO Add-in, the registry entries are automatically created on the end-user computer. Si vous utilisez Windows Installer pour déployer votre complément, VSTO, vous devez configurer le projet InstallShield Limited Edition pour créer les entrées de Registre sur l’ordinateur de l’utilisateur final.If you use Windows Installer to deploy your VSTO Add-in, you must configure the InstallShield Limited Edition project to create the registry entries on the end-user computer.

Pour plus d’informations sur la façon dont les entrées de Registre sont utilisées pendant le processus de chargement des compléments VSTO, consultez Architecture of VSTO Add-ins.For more information about how the registry entries are used during the load process for VSTO Add-ins, see Architecture of VSTO Add-ins.

Note

Dans cette rubrique, le texte ID du complément représente l'ID unique de votre complément VSTO.In this topic, the text add-in ID represents a unique ID for your VSTO Add-in. Par défaut, l'ID est le nom de l'assembly de votre complément VSTO.By default, the ID is the name of your VSTO Add-in assembly.

Inscrire des Compléments VSTO pour l’utilisateur actuel et tous les utilisateursRegister VSTO Add-ins for the current user vs. all users

Quand un complément VSTO est installé, il peut être inscrit de deux façons :When a VSTO Add-in is installed, it can be registered in two ways:

  • Pour l’utilisateur actuel uniquement (autrement dit, il est disponible uniquement pour l’utilisateur qui est connecté à l’ordinateur lorsque le composant logiciel complément VSTO est installé).For the current user only (that is, it is available only to the user that is logged on to the computer when the VSTO Add-in is installed). Dans ce cas, les entrées de Registre sont créées sous le HKEY_CURRENT_USER.In this case, the registry entries are created under the HKEY_CURRENT_USER.

  • Pour tous les utilisateurs (tout utilisateur qui ouvre une session sur l’ordinateur peut utiliser le composant logiciel complément VSTO).For all users (that is, any user that logs on to the computer can use the VSTO Add-in). Dans ce cas, les entrées de Registre sont créées sous HKEY_LOCAL_MACHINE.In this case, the registry entries are created under HKEY_LOCAL_MACHINE.

    Tous les compléments VSTO que vous créez à l'aide de Visual Studio peuvent être inscrits pour l'utilisateur actuel.All VSTO Add-ins that you create by using Visual Studio can be registered for the current user. En revanche, ils ne peuvent être inscrits pour tous les utilisateurs que dans certains scénarios particuliers.However, VSTO Add-ins can be registered for all users only in certain scenarios. Ces scénarios dépendent de la version de Microsoft Office installée sur l'ordinateur et de la façon dont le complément VSTO a été déployé.These scenarios depend on the version of Microsoft Office on the computer and how the VSTO Add-in was deployed.

Version de Microsoft OfficeMicrosoft Office version

Applications Office peuvent charger des Compléments VSTO inscrits sous HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER.Office applications can load VSTO Add-ins that are registered under HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER.

Pour charger des Compléments VSTO inscrits sous HKEY_LOCAL_MACHINE, les ordinateurs doivent disposer des mises à jour 976477 installé.To load VSTO Add-ins that are registered under HKEY_LOCAL_MACHINE, computers must have update package 976477 installed. Pour plus d’informations, consultez http://go.microsoft.com/fwlink/?LinkId=184923.For more information, see http://go.microsoft.com/fwlink/?LinkId=184923.

Type de déploiementDeployment type

Si vous utilisez ClickOnce pour déployer un complément VSTO, ce dernier ne peut être inscrit que pour l'utilisateur actuel.If you use ClickOnce to deploy a VSTO Add-in, the VSTO Add-in can be registered only for the current user. Effet, ClickOnce prend uniquement en charge la création de clés sous HKEY_CURRENT_USER.This is because ClickOnce only supports creating keys under HKEY_CURRENT_USER. Si vous voulez inscrire un complément VSTO pour tous les utilisateurs d'un ordinateur, vous devez déployer ce complément à l'aide de Windows Installer.If you want to register a VSTO Add-in to all users on a computer, you must use Windows Installer to deploy the VSTO Add-in. Pour plus d’informations sur ces types de déploiement, consultez déployer une solution Office à l’aide de ClickOnce et déployer une solution Office à l’aide de Windows Installer.For more information about these deployment types, see Deploy an Office solution by using ClickOnce and Deploy an Office solution by using Windows Installer.

Entrées du RegistreRegistry entries

Les entrées de Registre de complément VSTO nécessaires se trouvent sous la clé de Registre suivante pour toutes les applications, sauf Visio, où racine est HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE .The required VSTO Add-in registry entries are located under the following registry key for all applications except Visio, where Root is HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE.

Ensemble des applications sauf VisioAll applications except for Visio

version d'OfficeOffice version Chemin d'accès de configurationConfiguration Path
32 bits32-bit Racine\Software\Microsoft\Office\nom de l’application\Addins\ID du complémentRoot\Software\Microsoft\Office\application name\Addins\add-in ID
64 bits64-bit Racine\Software\Wow6432Node\Microsoft\Office\nom de l’application\Addins\ID du complémentRoot\Software\Wow6432Node\Microsoft\Office\application name\Addins\add-in ID

VisioVisio

version d'OfficeOffice version Chemin d'accès de configurationConfiguration Path
32 bits32-bit Racine\Software\Microsoft\Visio\Addins\ID du complémentRoot\Software\Microsoft\Visio\Addins\add-in ID
64 bits64-bit Racine\Software\Wow6432Node\Visio\Addins\ID du complémentRoot\Software\Wow6432Node\Visio\Addins\add-in ID

Le tableau suivant répertorie les entrées sous cette clé de Registre.The following table lists the entries under this registry key.

EntréeEntry TypeType ValueValue
DescriptionDescription REG_SZREG_SZ Obligatoire.Required. Brève description du complément VSTO.A brief description of the VSTO Add-in.

Cette description s'affiche quand l'utilisateur sélectionne le complément VSTO dans le volet Compléments de la boîte de dialogue Options de l'application Microsoft Office.This description is displayed when the user selects the VSTO Add-in in the Add-Ins pane of the Options dialog box in the Microsoft Office application.
FriendlyNameFriendlyName REG_SZREG_SZ Obligatoire.Required. Nom descriptif du complément VSTO qui s'affiche dans la boîte de dialogue Compléments COM de l'application Microsoft Office.A descriptive name of the VSTO Add-in that is displayed in the COM Add-Ins dialog box in the Microsoft Office application. La valeur par défaut est l'ID du complément VSTO.The default value is the VSTO Add-in ID.
LoadBehaviorLoadBehavior REG_DWORDREG_DWORD Obligatoire.Required. Valeur qui spécifie le moment où l'application tente de charger le complément VSTO, ainsi que l'état actuel du complément VSTO (chargé ou non chargé).A value that specifies when the application attempts to load the VSTO Add-in and the current state of the VSTO Add-in (loaded or unloaded).

Par défaut, cette entrée a la valeur 3, ce qui indique que le complément VSTO est chargé au démarrage.By default, this entry is set to 3, which specifies that the VSTO Add-in is loaded at startup. Pour plus d’informations, consultez valeurs LoadBehavior.For more information, see LoadBehavior values. Remarque : si un utilisateur désactive le complément à VSTO, cette action modifie LoadBehavior valeur dans le HKEY_CURRENT_USER ruche du Registre.Note: If a user disables the VSTO Add-in, that action modifies LoadBehavior value in the HKEY_CURRENT_USER registry hive. Pour chaque utilisateur, la valeur de la LoadBehavior dans la ruche HKEY_CURRENT_USER remplace la valeur par défaut LoadBehavior défini dans le HKEY_LOCAL_MACHINE hive.For each user, the value of the LoadBehavior value in the HKEY_CURRENT_USER hive overrides the default LoadBehavior defined in the HKEY_LOCAL_MACHINE hive.
ManifestManifest REG_SZREG_SZ Obligatoire.Required. Chemin d'accès complet du manifeste de déploiement du complément VSTO.The full path of the deployment manifest for the VSTO Add-in. Le chemin d'accès peut être un emplacement sur l'ordinateur local, un partage réseau (UNC) ou un serveur web (HTTP).The path can be a location on the local computer, a network share (UNC), or a Web server (HTTP).

Si vous utilisez Windows Installer pour déployer la solution, vous devez ajouter le préfixe file:/// au chemin d'accès du manifeste .If you use Windows Installer to deploy the solution, you must add the prefix file:/// to the manifest path. Vous devez également ajouter la chaîne |vstolocal (autrement dit, la barre verticale | suivie vstolocal) à la fin de ce chemin d’accès.You must also append the string |vstolocal (that is, the pipe character | followed by vstolocal) to the end of this path. Cela permet de garantir que votre solution est chargée à partir du dossier d'installation, et non à partir du cache ClickOnce.This ensures that your solution is loaded from the installation folder, rather than the ClickOnce cache. Pour plus d’informations, consultez déployer une solution Office à l’aide de Windows Installer.For more information, see Deploy an Office solution by using Windows Installer. Remarque : quand vous générez un complément, VSTO sur l’ordinateur de développement, Visual Studio ajoute automatiquement le |vstolocal chaîne pour cette entrée de Registre.Note: When you build a VSTO Add-in on the development computer, Visual Studio automatically appends the |vstolocal string to this registry entry.

Entrées de Registre des zones de formulaire OutlookRegistry entries for Outlook form regions

Si vous créez une zone de formulaire personnalisée dans un complément VSTO pour Outlook, des entrées de Registre supplémentaires sont utilisées pour inscrire la zone de formulaire dans Outlook.If you create a custom form region in a VSTO Add-in for Outlook, additional registry entries are used to register the form region with Outlook. Ces entrées sont créées sous une autre clé de Registre pour chaque classe de message prise en charge par la zone de formulaire.These entries are created under a different registry key for each message class that the form region supports. Ces clés de Registre sont à l’emplacement suivant, où racine est HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE.These registry keys are in the following location, where Root is HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE.

Racine\Software\Microsoft\Office\Outlook\FormRegions\message, classeRoot\Software\Microsoft\Office\Outlook\FormRegions\message class

Comme pour les autres entrées de Registre partagées par l'ensemble des compléments VSTO, Visual Studio crée les entrées de Registre de zones de formulaire sur l'ordinateur de développement au moment où vous générez votre projet.Like the other registry entries shared by all VSTO Add-ins, Visual Studio creates the form region registry entries on the development computer when you build your project. Si vous utilisez ClickOnce pour déployer votre complément, VSTO, les entrées de Registre sont automatiquement créées sur l’ordinateur de l’utilisateur final.If you use ClickOnce to deploy your VSTO Add-in, the registry entries are automatically created on the end-user computer. Si vous utilisez Windows Installer pour déployer votre complément, VSTO, vous devez configurer le projet InstallShield Limited Edition pour créer les entrées de Registre sur l’ordinateur de l’utilisateur final.If you use Windows Installer to deploy your VSTO Add-in, you must configure the InstallShield Limited Edition project to create the registry entries on the end-user computer.

Pour plus d’informations sur les entrées de Registre des zones de formulaire, consultez spécifier l’emplacement d’une zone de formulaire dans un formulaire personnalisé.For more information about the form region registry entries, see Specify the location of a form region in a custom form. Pour plus d’informations sur les zones de formulaire Outlook, consultez zones de formulaire Outlook de créer.For more information about Outlook form regions, see Create Outlook form regions.

Valeurs de LoadBehaviorLoadBehavior values

Le LoadBehavior entrée sous le racine\Software\Microsoft\Office\nom de l’application\Addins\complément ID clé contient une combinaison d’opérations de bits de valeurs qui spécifient le comportement d’exécution de la macro complémentaire VSTO.The LoadBehavior entry under the Root\Software\Microsoft\Office\application name\Addins\add-in ID key contains a bitwise combination of values that specify the run time behavior of the VSTO Add-in. Le bit d'ordre le plus bas (valeurs 0 et 1) indique si le complément VSTO est actuellement chargé ou non chargé.The lowest order bit (values 0 and 1) indicates whether the VSTO Add-in is currently unloaded or loaded. Les autres bits indiquent le moment où l'application tente de charger le complément VSTO.Other bits indicate when the application attempts to load the VSTO Add-in.

En règle générale, les LoadBehavior entrée est destinée à être définie sur 0, 3 ou 16 (au format décimal) lorsque le composant logiciel complément VSTO est installé sur les ordinateurs des utilisateurs finaux.Typically, the LoadBehavior entry is intended to be set to 0, 3, or 16 (in decimal) when the VSTO Add-in is installed on end-user computers. Par défaut, Visual Studio affecte la valeur 3 à l'entrée LoadBehavior du complément VSTO quand vous le générez ou que vous le publiez.By default, Visual Studio sets the LoadBehavior entry of your VSTO Add-in to 3 when you build or publish it.

Le tableau suivant répertorie toutes les valeurs possibles de l'entrée LoadBehavior .The following table lists all the possible values of the LoadBehavior entry. Certaines descriptions de ce tableau font référence au chargement manuel ou par programmation d'un complément VSTO.Some descriptions in this table refer to loading a VSTO Add-in manually or programmatically. Pour charger un complément VSTO manuellement, cochez la case à côté du complément VSTO dans la boîte de dialogue Compléments COM de l'application.To load a VSTO Add-in manually, select the check box next to the VSTO Add-in in the COM Add-Ins dialog box in the application. Pour charger un complément VSTO par programmation, affectez à la propriété <xref:Microsoft.Office.Core.COMAddIn.Connect%2A> de l'objet Microsoft.Office.Core.COMAddIn qui représente ce complément la valeur true.To load a VSTO Add-in programmatically, set the <xref:Microsoft.Office.Core.COMAddIn.Connect%2A> property of the Microsoft.Office.Core.COMAddIn object that represents the VSTO Add-in to true.

Valeur (au format décimal)Value (in decimal) État du complément VSTOVSTO Add-in status Comportement de chargement du complément VSTOVSTO Add-in load behavior DescriptionDescription
00 Non chargéUnloaded Ne pas charger automatiquementDo not load automatically L'application ne tente jamais de charger le complément VSTO automatiquement.The application never tries to load the VSTO Add-in automatically. L'utilisateur peut essayer de charger manuellement le complément VSTO. Sinon, le complément VSTO peut être chargé par programmation.The user can try to manually load the VSTO Add-in, or the VSTO Add-in can be loaded programmatically.

Si le complément VSTO est correctement chargé, la valeur LoadBehavior reste 0, mais l'état du complément VSTO dans la boîte de dialogue Compléments COM est mis à jour pour indiquer que ce complément est chargé.If the VSTO Add-in is successfully loaded, the LoadBehavior value remains 0, but the status of the VSTO Add-in in the COM Add-ins dialog box is updated to indicate that the VSTO Add-in is loaded.
11 ChargéLoaded Ne pas charger automatiquementDo not load automatically L'application ne tente jamais de charger le complément VSTO automatiquement.The application never tries to load the VSTO Add-in automatically. L'utilisateur peut essayer de charger manuellement le complément VSTO. Sinon, le complément VSTO peut être chargé par programmation.The user can try to manually load the VSTO Add-in, or the VSTO Add-in can be loaded programmatically.

Bien que le compléments COM boîte de dialogue indique que le composant logiciel complément VSTO est chargé au démarrage de l’application, le composant logiciel complément VSTO n’est pas chargé tant qu’il est chargé manuellement ou par programmation.Although the COM Add-ins dialog box indicates that the VSTO Add-in is loaded after the application starts, the VSTO Add-in isn't loaded until it is loaded manually or programmatically.

Si l'application charge correctement le complément VSTO, la valeur de LoadBehavior passe à 0, et reste à 0 après la fermeture de l'application.If the application successfully loads the VSTO Add-in, the LoadBehavior value changes to 0, and remains at 0 after the application closes.
22 Non chargéUnloaded Charger au démarrageLoad at startup L'application ne tente pas de charger le complément VSTO automatiquement.The application does not try to load the VSTO Add-in automatically. L'utilisateur peut essayer de charger manuellement le complément VSTO. Sinon, le complément VSTO peut être chargé par programmation.The user can try to manually load the VSTO Add-in, or the VSTO Add-in can be loaded programmatically.

Si l'application charge correctement le complément VSTO, la valeur de LoadBehavior passe à 3, et reste à 3 après la fermeture de l'application.If the application successfully loads the VSTO Add-in, the LoadBehavior value changes to 3, and remains at 3 after the application closes.
33 ChargéLoaded Charger au démarrageLoad at startup L'application tente de charger le complément VSTO au démarrage de l'application.The application tries to load the VSTO Add-in when the application starts. Il s'agit de la valeur par défaut quand vous générez ou que vous publiez un complément VSTO dans Visual Studio.This is the default value when you build or publish a VSTO Add-in in Visual Studio.

Si l'application charge correctement le complément VSTO, la valeur de LoadBehavior reste égale à 3.If the application successfully loads the VSTO Add-in, the LoadBehavior value remains 3. Si une erreur se produit lors du chargement du complément VSTO, la valeur de LoadBehavior passe à 2, et reste à 2 après la fermeture de l'application.If an error occurs when loading the VSTO Add-in, the LoadBehavior value changes to 2, and remains at 2 after the application closes.
88 Non chargéUnloaded Charger à la demandeLoad on demand L'application ne tente pas de charger le complément VSTO automatiquement.The application does not try to load the VSTO Add-in automatically. L'utilisateur peut essayer de charger manuellement le complément VSTO. Sinon, le complément VSTO peut être chargé par programmation.The user can try to manually load the VSTO Add-in, or the VSTO Add-in can be loaded programmatically.

Si l'application charge correctement le complément VSTO, la valeur de LoadBehavior passe à 9.If the application successfully loads the VSTO Add-in, the LoadBehavior value changes to 9.
99 ChargéLoaded Charger à la demandeLoad on demand Le complément VSTO est chargé seulement quand l'application le requiert, par exemple quand un utilisateur clique sur un élément d'interface utilisateur qui utilise des fonctionnalités du complément VSTO (par exemple un bouton personnalisé dans le ruban).The VSTO Add-in will be loaded only when the application requires it, such as when a user clicks a UI element that uses functionality in the VSTO Add-in (for example, a custom button in the Ribbon).

Si l'application charge correctement le complément VSTO, la valeur de LoadBehavior reste 9, mais l'état de ce complément dans la boîte de dialogue Compléments COM est mis à jour pour indiquer que le complément VSTO est actuellement chargé.If the application successfully loads the VSTO Add-in, the LoadBehavior value remains 9, but the status of the VSTO Add-in in the COM Add-ins dialog box is updated to indicate that the VSTO Add-in is currently loaded. Si une erreur se produit lors du chargement du complément VSTO, la valeur de LoadBehavior passe à 8.If an error occurs when loading the VSTO Add-in, the LoadBehavior value changes to 8.
1616 ChargéLoaded Charger la première fois, puis charger à la demandeLoad first time, then load on demand Définissez cette valeur si vous voulez que votre complément VSTO soit chargé à la demande.Set this value if you want your VSTO Add-in to be loaded on demand. L'application charge le complément VSTO quand l'utilisateur exécute l'application pour la première fois.The application loads the VSTO Add-in when the user runs the application for the first time. La prochaine fois que l'utilisateur exécute l'application, cette dernière charge tous les éléments d'interface utilisateur définis par le complément VSTO. Toutefois, le complément VSTO n'est pas chargé tant que l'utilisateur n'a pas cliqué sur un élément d'interface utilisateur associé à ce complément.The next time the user runs the application, the application loads any UI elements that are defined by the VSTO Add-in, but the VSTO Add-in is not loaded until the user clicks a UI element that is associated with the VSTO Add-in.

Quand l'application charge correctement le complément VSTO pour la première fois, la valeur de LoadBehavior reste 16 durant le chargement de ce complément.When the application successfully loads the VSTO Add-in for the first time, the LoadBehavior value remains 16 while the VSTO Add-in is loaded. Après la fermeture de l'application, la valeur LoadBehavior passe à 9.After the application closes, the LoadBehavior value changes to 9.

Voir aussiSee also

Architecture des solutions Office dans Visual Studio Architecture of Office solutions in Visual Studio
Architecture des Compléments VSTO Architecture of VSTO Add-ins
Générer des solutions Office Build Office solutions
Déployer une solution OfficeDeploy an Office solution