Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Pour créer un groupe personnalisé de paramètres que vous pouvez partager avec d’autres utilisateurs ou réutiliser dans plusieurs projets, utilisez le Gestionnaire de propriétés pour créer une feuille de propriétés (un fichier .props) afin de stocker les paramètres de chaque type de projet que vous souhaitez pouvoir réutiliser ou partager avec d’autres utilisateurs. L’utilisation des feuilles de propriétés est beaucoup moins sujette aux erreurs que les autres méthodes de création de paramètres « globaux ».
Importante
Le problème avec les fichiers *.user
Les versions antérieures de Visual Studio utilisaient des feuilles de propriétés globales dont le nom de fichier se terminait par .user et qui se trouvaient dans le dossier \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\. Nous ne recommandons plus l'utilisation de ces fichiers, car ils définissent des propriétés pour les configurations de projet sur la base de chaque utilisateur et de chaque ordinateur. Ces paramètres « globaux » peuvent perturber les builds, surtout lorsque vous ciblez plusieurs plateformes sur votre ordinateur de build. Par exemple, si vous avez un projet MFC et un projet Windows Phone, les propriétés .user seraient non valides pour l’un d’eux. Les feuilles de propriétés réutilisables sont plus flexibles et plus fiables.
Bien que les fichiers .user soient toujours installés par Visual Studio et participent à l’héritage des propriétés, ils sont vides par défaut. La meilleure pratique consiste à supprimer toute référence à ces paramètres dans le Gestionnaire de propriétés afin de garantir que vos projets fonctionnent indépendamment des paramètres propres à chaque utilisateur ou à chaque ordinateur. Cette pratique est importante pour garantir un comportement correct dans un environnement SCC (contrôle de code source).
Pour afficher le Gestionnaire de propriétés, dans la barre de menus, sélectionnez Affichage>Gestionnaire de propriétés ou Affichage>Autres fenêtres>Gestionnaire de propriétés, selon vos paramètres.
Si vous souhaitez appliquer un ensemble de propriétés courantes et fréquemment utilisées à plusieurs projets, vous pouvez utiliser Gestionnaire de propriétés pour les enregistrer dans un fichier property sheet réutilisable, qui porte par convention l’extension de fichier .props. Vous pouvez appliquer la feuille (ou les feuilles) à de nouveaux projets afin de ne pas avoir à définir intégralement ces propriétés.
Sous chaque nœud de configuration, vous voyez des nœuds pour chaque feuille de propriétés qui s’applique à cette configuration. Le système ajoute des feuilles de propriétés qui définissent des valeurs communes selon les options que vous choisissez dans l’Assistant Application quand vous créez le projet. Cliquez avec le bouton droit sur n’importe quel nœud et choisissez Propriétés pour voir les propriétés qui s’appliquent à ce nœud. Toutes les feuilles de propriétés sont importées automatiquement dans la feuille de propriétés primaire du projet (ms.cpp.props) et sont évaluées par ordre d’apparition dans le Gestionnaire de propriétés. Vous pouvez les déplacer pour changer l’ordre d’évaluation. Les feuilles de propriétés qui sont évaluées par la suite remplacent les valeurs dans les feuilles précédemment évaluées. Pour plus d’informations sur l’ordre d’évaluation dans le fichier .vcxproj, les fichiers .props et .targets, les variables d’environnement et la ligne de commande, consultez Héritage de propriétés de projet.
Si vous choisissez Ajouter une nouvelle feuille de propriétés et que vous sélectionnez, par exemple, la feuille de propriétés MyProps.props, une boîte de dialogue Page de propriétés apparaît. Remarquez qu'elle s'applique à la feuille de propriétés MyProps ; toutes les modifications que vous apportez sont écrites dans la feuille, et non dans le fichier projet (.vcxproj).
Les propriétés dans une feuille de propriétés sont remplacées si la même propriété est définie directement dans le fichier .vcxproj.
Vous pouvez importer une feuille de propriétés aussi souvent que nécessaire. Plusieurs projets d'une solution peuvent hériter des paramètres de la feuille de propriétés et un projet peut avoir plusieurs feuilles. Une feuille de propriétés peut hériter elle-même des paramètres d'une autre feuille de propriétés.
Vous pouvez également créer une feuille de propriétés commune pour plusieurs configurations. Pour créer une feuille de propriétés pour chaque configuration, ouvrez le menu contextuel associé à l’une d’elles, choisissez Ajouter une feuille de propriétés existante, puis ajoutez les autres feuilles. Cependant, si vous utilisez une feuille de propriétés commune, les propriétés que vous définissez s’appliquent à toutes les configurations auxquelles la feuille s’applique. L’IDE n’indique pas quels projets ou autres feuilles de propriétés héritent d’une feuille de propriétés donnée.
Dans les solutions volumineuses qui comportent de nombreux projets, il peut être utile de créer une feuille de propriétés commune à tous les projets de la solution. Créez la feuille de propriétés comme d’habitude. Utilisez le Gestionnaire de propriétés pour ajouter cette feuille de propriétés à chaque projet de la solution. Si nécessaire au niveau du projet, vous pouvez ajouter une autre feuille de propriétés pour définir des valeurs spécifiques au projet.
Importante
Un fichier .props par défaut ne participe pas au contrôle de code source car il n’est pas créé en tant qu’élément de projet. Vous pouvez ajouter manuellement le fichier comme élément de solution si vous souhaitez l'inclure dans le contrôle de code source.
Pour créer une feuille de propriétés
Dans la barre de menus, choisissez Affichage>Gestionnaire de propriétés ou Affichage>Autres fenêtres>Gestionnaire de propriétés. Le Gestionnaire de propriétés s’ouvre.
Pour définir la portée de la feuille de propriétés, sélectionnez l'élément auquel elle s'applique. Cet élément peut être une configuration particulière ou une autre feuille de propriétés. Ouvrez le menu contextuel de cet élément, puis choisissez Ajouter une nouvelle feuille de propriétés de projet. Spécifiez un nom et un emplacement.
Dans le Gestionnaire de propriétés, ouvrez la nouvelle feuille de propriétés et définissez les propriétés à inclure.