Guide pratique pour intégrer les outils personnalisés dans les propriétés du projet
Vous pouvez ajouter des options d’outil personnalisées à la fenêtre Pages de propriétés Visual Studio en créant un fichier XML.
La section Propriétés de configuration de la fenêtre Pages de propriétés affiche les groupes de paramètres appelés règles. Chaque règle contient les paramètres d’un outil ou d’un groupe de fonctionnalités. Par exemple, la règle Éditeur de liens contient les paramètres de l’outil Éditeur de liens. Les paramètres d’une règle peuvent être subdivisés en catégories.
Vous pouvez créer un fichier de règles qui contient des propriétés pour votre outil personnalisé afin que les propriétés soient chargées au démarrage de Visual Studio. Pour plus d’informations sur la modification du fichier, consultez la partie 2 de l’extensibilité de plateforme sur le blog de l’équipe de projet Visual Studio.
Le dossier dans lequel placer votre fichier de règle dépend des paramètres régionaux et de la version de Visual Studio en cours d’utilisation. Dans une invite de commandes développeur Visual Studio 2015 ou antérieure, le dossier règles est %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>
. La <version>
valeur est v140
dans Visual Studio 2015. Il <locale>
s’agit d’un LCID, par exemple, 1033
pour l’anglais. Vous utiliserez un chemin différent pour chaque édition de Visual Studio installée et pour chaque langue. Par exemple, le chemin du dossier de règles par défaut pour l’édition Community de Visual Studio 2015 en anglais peut être C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\v140\1033\
.
Le dossier dans lequel placer votre fichier de règle dépend des paramètres régionaux et de la version de Visual Studio en cours d’utilisation. Dans une invite de commandes développeur Visual Studio 2017, le dossier règles est %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\
. Il <locale>
s’agit d’un LCID, par exemple, 1033
pour l’anglais. Dans une invite de commandes développeur Visual Studio 2015 ou antérieure, le dossier règles est %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\
, où la <version>
valeur se trouve v140
dans Visual Studio 2015. Vous utiliserez un chemin différent pour chaque édition de Visual Studio installée et pour chaque langue. Par exemple, le chemin d’accès au dossier de règles par défaut pour l’édition Community de Visual Studio 2017 en anglais peut être C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\VC\VCTargets\1033\
.
Le dossier dans lequel placer votre fichier de règle dépend des paramètres régionaux et de la version de Visual Studio en cours d’utilisation. Dans une invite de commandes développeur Visual Studio 2019 ou ultérieure, le dossier règles est %VSINSTALLDIR%MSBuild\Microsoft\VC\<version>\<locale>\
, où la <version>
valeur se trouve v160
dans Visual Studio 2019. Il <locale>
s’agit d’un LCID, par exemple, 1033
pour l’anglais. Dans Visual Studio 2017, le dossier règles est %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\
. Dans une invite de commandes développeur Visual Studio 2015 ou antérieure, le dossier règles est %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\
. Vous utiliserez un chemin différent pour chaque édition de Visual Studio installée et pour chaque langue. Par exemple, le chemin d’accès au dossier de règles par défaut pour Visual Studio 2019 Community edition en anglais peut être C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\VC\v160\1033\
.
Dans l’éditeur XML, créez un fichier XML.
Enregistrez le fichier dans le dossier de règles par défaut. Rectifiez le chemin en fonction de vos langue et édition de Visual Studio. Chaque règle figurant dans la fenêtre Pages de propriétés est représentée par un fichier XML de ce dossier. Veillez à ce que le fichier ait un nom unique dans le dossier.
Copiez le contenu d’un fichier de règles existant, par
rc.xml
exemple, fermez-le sans enregistrer les modifications, puis collez le contenu dans votre nouveau fichier XML. Vous pouvez copier n’importe quel fichier de schéma XML à utiliser comme modèle. Choisissez-en un similaire à votre outil.Dans le nouveau fichier XML, modifiez le contenu selon vos besoins. Veillez à modifier Rule Name et Rule.DisplayName en haut du fichier.
Enregistrer vos modifications et fermez le fichier.
Les fichiers XML dans le dossier règles sont chargés au démarrage de Visual Studio. Pour tester le nouveau fichier, redémarrez Visual Studio.
Dans Explorateur de solutions, cliquez avec le bouton droit sur un projet, puis choisissez Propriétés. Dans la fenêtre Pages de propriétés, vérifiez qu’il existe un nouveau nœud avec le nom de votre règle.