Concepteur de projets .NET
Utilisez le concepteur de projets pour spécifier les paramètres et les propriétés du projet pour .NET Core et .NET 5+. Pour .NET Framework, consultez Qu’est-ce que le Concepteur de projets .NET ?.
Pour accéder au Concepteur de projets, choisissez un nœud de projet (et non le nœud solution de) dans Explorateur de solutions. Choisissez ensuite Project>Properties dans la barre de menus. Le du Concepteur de projets s’affiche.
Note
Votre ordinateur peut afficher différents noms ou emplacements pour certains des éléments de l’interface utilisateur Visual Studio de cet article. Vous utilisez peut-être une édition différente de Visual Studio ou des paramètres d’environnement différents. Pour plus d’informations, consultez Personnaliser l’IDE.
Application, Paramètres généraux
Les options suivantes vous permettent de configurer les paramètres généraux de l’application.
type de sortie
Spécifie le type d’application à générer. Les valeurs sont différentes en fonction du type de projet. Par exemple, pour un projet application console, vous pouvez spécifier d’application Windows, application consoleou bibliothèque de classes comme type de sortie.
Pour plus d’informations sur la propriété Type de sortie, consultez /target (Options du compilateur C#).
Pour plus d’informations sur l’accès à cette propriété par programmation, consultez OutputType.
framework cible
Spécifie la version de .NET cible par l’application. Cette option peut avoir des valeurs différentes selon les versions de .NET installées sur votre ordinateur.
Pour un projet qui cible .NET Core ou .NET 5+, les versions disponibles peuvent apparaître comme suit :
Note
Pour les applications ClickOnce, les packages requis répertoriés dans la boîte de dialogue Conditions préalables sont définis automatiquement la première fois que vous ouvrez la boîte de dialogue. Si vous modifiez par la suite l’infrastructure cible du projet, vous devez sélectionner manuellement les prérequis pour correspondre au nouveau framework cible.
Pour plus d’informations, consultez Vue d’ensemble du ciblage du framework.
système d’exploitation cible
Spécifie le système d’exploitation que le projet cible. Combiné au framework cible, cela génère une TF spécifique au système d’exploitation .NET 5+.
'objet Startup
Définit le point d’entrée à appeler lorsque l’application se charge. En règle générale, il est défini sur le formulaire principal de votre application ou sur la procédure Main qui doit s’exécuter au démarrage de l’application. Étant donné que les bibliothèques de classes n’ont pas de point d’entrée, leur seule option pour cette propriété est (non définie).
Par défaut, dans un projet d’application WPF, cette option est définie sur (non défini). L’autre option est [nom_projet].App. Dans un projet WPF, vous devez définir l’URI de démarrage pour charger une ressource d’interface utilisateur au démarrage de l’application. Pour ce faire, ouvrez le fichier Application.xaml dans votre projet et définissez la propriété StartupUri sur un fichier .xaml dans votre projet, par exemple Window1.xaml. Pour obtenir la liste des éléments racines acceptables, consultez StartupUri. Vous devez également définir une méthode public static void Main() dans une classe du projet. Cette classe apparaît dans la liste 'objet Startup sous la forme ProjectName.ClassName. Vous pouvez ensuite sélectionner la classe comme objet de démarrage.
Pour plus d’informations, consultez /main (options du compilateur C#). Pour accéder à cette propriété par programmation, consultez StartupObject.
nom de l’assembly
Spécifie le nom du fichier de sortie qui contiendra le manifeste d’assembly. La modification de cette propriété modifie également la propriété Nom de sortie.
Vous pouvez également apporter cette modification à partir de la ligne de commande à l’aide de /out (options du compilateur C#).
Pour accéder à cette propriété par programmation, consultez AssemblyName.
espace de noms par défaut
Spécifie l’espace de noms de base pour les fichiers ajoutés au projet.
Consultez d’espace de noms pour plus d’informations sur la création d’espaces de noms dans votre code.
Pour accéder à cette propriété par programmation, consultez RootNamespace.
Paramètres de l’application, des ressources Win32
icône
Définit le fichier .ico que vous souhaitez utiliser comme icône de programme. Cliquez sur Parcourir pour rechercher un graphique existant ou tapez le nom du fichier souhaité. Pour plus d’informations, consultez /win32icon (options du compilateur C#).
Pour accéder à cette propriété par programmation, consultez ApplicationIcon.
Pour plus d’informations sur la création d’une icône, consultez 'éditeur d’images pour les icônes.
Ressources
L’option Resources vous aide à configurer les paramètres des ressources pour votre application. Par défaut, l’icône et les options manifeste sont activées. Cela vous permet de sélectionner votre propre icône ou de sélectionner différentes options de génération de manifeste. Laissez cette case d’option sélectionnée, sauf si vous fournissez un fichier de ressources pour le projet.
Si vous sélectionnez fichier de ressources, configurez un fichier de ressources pour le projet. Entrez un nom de chemin d’accès ou utilisez le bouton Parcourir pour ajouter un fichier de ressources Win32 au projet. Pour plus d’informations, consultez Créer des fichiers de ressources pour les applications .NET.
manifeste
Sélectionne une option de génération de manifeste lorsque l’application s’exécute sur Windows sous Contrôle de compte d’utilisateur (UAC). Cette option peut avoir les valeurs suivantes :
Incorporer le manifeste avec les paramètres par défaut. Prend en charge la manière classique dont Visual Studio fonctionne sur Windows, qui consiste à incorporer des informations de sécurité dans le fichier exécutable de l’application, en spécifiant que
requestedExecutionLevelêtreAsInvoker. Il s’agit de l’option par défaut.Créer une application sansmanifeste . Cette méthode est appelée virtualisation. Utilisez cette option pour la compatibilité avec les applications antérieures.
Utiliser un manifeste personnalisé. Vous permet d’entrer un chemin d’accès ou d’accéder à un manifeste personnalisé pour le projet.
Paramètres globaux des utilisations
global implicite utilise
Active ou désactive globale à l’aide de, ce qui vous permet d’utiliser des types définis dans un espace de noms sans spécifier l’espace de noms complet.
gérer les utilisations globales implicites
Ajoutez et supprimez manuellement des utilisations globales pour une utilisation dans vos projets.
Générer, paramètres généraux
symboles de compilation conditionnelle
Spécifie les symboles sur lesquels effectuer la compilation conditionnelle. Séparez les symboles avec un point-virgule (« ; »). Pour plus d’informations, consultez /define (options du compilateur C#).
déboguer des symboles personnalisés
Spécifie des symboles pour la compilation conditionnelle pour les builds Debug. Les symboles de débogage par défaut sont affichés dans une chaîne, séparées par des points-virgules.
libérer des symboles personnalisés
Spécifie des symboles pour la compilation conditionnelle pour les builds Release. Les symboles de mise en production par défaut sont affichés dans une chaîne, séparées par des points-virgules.
cible de plateforme
Spécifie le processeur à cibler par le fichier de sortie. Choisissez x86 pour n’importe quel processeur compatible Intel 32 bits, choisissez x64 pour n’importe quel processeur compatible 64 bits, choisissez ARM pour les processeurs ARM, ou choisissez n’importe quel processeur pour spécifier qu’un processeur est acceptable. n’importe quelle processeur est la valeur par défaut des projets, car elle permet à l’application de s’exécuter sur la plus grande gamme de matériel.
Pour plus d’informations, consultez /platform (options du compilateur C#).
Nullable
Spécifie le contexte nullable C# à l’échelle du projet. Cette option d’interface utilisateur a été introduite dans Visual Studio 16.5 et est activée uniquement pour les projets qui utilisent C# 8.0 ou version ultérieure.
Pour plus d’informations, consultez contextes nullables.
Générer des informations d’assembly
Spécifie si propriétés de projet liées au package sont transformées en attributs d’assembly. Pour plus d’informations, consultez la propriété GenerateAssemblyInfo.
code non sécurisé
Autorise le code qui utilise le mot clé non sécurisé à compiler. Pour plus d’informations, consultez /unsafe (options du compilateur C#).
Optimiser le code
Activez ou désactivez les optimisations effectuées par le compilateur pour rendre votre fichier de sortie plus petit, plus rapide et plus efficace. Pour plus d’informations, consultez /optimize (options du compilateur C#).
symboles de débogage
Spécifie le type d’informations de débogage générées par le compilateur. Pour plus d’informations sur la configuration des performances de débogage d’une application, consultez option de compilateur DebugType. Ce paramètre a les options suivantes :
aucun
Spécifie qu’aucune information de débogage ne sera générée.
complète
Permet d’attacher un débogueur au programme en cours d’exécution.
pdbonly
Autorise le débogage du code source lorsque le programme est démarré dans le débogueur, mais affiche uniquement l’assembleur lorsque le programme en cours d’exécution est attaché au débogueur.
portable
Produit un . Fichier PDB, fichier de symboles portables non spécifiques à la plateforme qui fournit d’autres outils, en particulier des débogueurs, des informations sur ce qui se trouve dans le fichier exécutable principal et la façon dont il a été produit. Pour plus d’informations, consultez PDB portable.
incorporé
Incorpore les informations de symbole portable dans l’assembly. Aucun externe . Le fichier PDB est généré.
Pour plus d’informations, consultez /debug (options du compilateur C#).
Paramètres de génération, d’erreurs et d’avertissements
Les paramètres suivants sont utilisés pour configurer les options d’erreur et d’avertissement pour le processus de génération.
niveau d’avertissement
Spécifie le niveau à afficher pour les avertissements du compilateur. Pour plus d’informations, consultez /warn (Options du compilateur C#).
Supprimer des avertissements spécifiques
Bloque la capacité du compilateur à générer un ou plusieurs avertissements spécifiques. Séparez plusieurs numéros d’avertissement avec une virgule ou un point-virgule. Pour plus d’informations, consultez /nowarn (Options du compilateur C#).
traiter les avertissements comme des erreurs
Sélectionnez si les avertissements sont traités comme des erreurs pendant le processus de génération. Pour plus d’informations, consultez /warnaserror (options du compilateur C#).
Traiter des avertissements spécifiques comme des erreurs
Spécifiez les avertissements traités comme des erreurs. Séparez plusieurs numéros d’avertissement avec une virgule ou un point-virgule.
Pourboire
Si vous ne souhaitez pas que les avertissements d’analyse du code soient traités comme des erreurs, consultez FAQ sur l’analyse du code.
Générer, paramètres de sortie
Les paramètres suivants sont utilisés pour configurer les options de sortie du processus de génération.
chemin de sortie de base
Spécifie l’emplacement des fichiers de sortie pour la configuration de ce projet. Entrez le chemin d’accès de la sortie de build dans cette zone, ou choisissez le bouton Parcourir pour spécifier un chemin d’accès. Le chemin d’accès est relatif ; si vous entrez un chemin d’accès absolu, il est enregistré en tant que relatif. Le chemin d’accès par défaut est bin\Debug ou bin\Release\.
Avec des configurations de build simplifiées, le système de projet détermine s’il faut générer une version de débogage ou de mise en production. La commande Générer à partir du menu Déboguer (F5) place la build dans l’emplacement de débogage, quel que soit le chemin de sortie que vous spécifiez. Toutefois, la commande Build à partir du menu Build le place dans l’emplacement que vous spécifiez. Pour plus d’informations, consultez Understanding Build Configurations.
assembly reference
Spécifie s’il faut générer un assembly de référence contenant l’API publique du projet.
fichier de documentation
Spécifie le nom d’un fichier dans lequel les commentaires de documentation seront traités. Pour plus d’informations, consultez /doc (options du compilateur C#).
Générer, paramètres d’événements
Pour plus d’informations sur les paramètres d’événement de génération, consultez Spécifier des événements de build (C#).
Générer, publier des paramètres
publication
Autorise l’exécution de la cible de publication MSBuild. Pour plus d’informations, consultez la propriété msBuild IsPublishable.
Publier les supprimés
Spécifie si le découpage est activé pendant le processus de publication. Pour plus d’informations, consultez propriétés liées à trim.
Publier un AOT natif
Spécifie s’il faut produire une application autonome et qui a été compilée à l’avance (AOT) en code natif. Pour plus d’informations, consultez déploiement AOT natif.
Paramètres de création, de nommage fort
signer le d’assembly
Activez cette case à cocher pour signer l’assembly et créer un fichier de clé fortement nommé. Pour plus d’informations sur la signature de l’assembly à l’aide du Project Designer, consultez Guide pratique pour signer un assembly (Visual Studio). Pour plus d’informations, consultez assemblys avec nom fort.
Cette option utilise l’outil Al.exe fourni par le Kit de développement logiciel (SDK) Windows pour signer l’assembly. Pour plus d’informations sur Al.exe, consultez How to : Sign an Assembly with a Strong Name.
liste fichier de clé de nom fort
Vous permet de spécifier un nouveau fichier de clé fortement nommé ou existant qui est utilisé pour signer l’assembly. Sélectionnez <Parcourir...> pour sélectionner un fichier de clé existant.
Signe différé uniquement
Activez cette case à cocher pour activer la signature différée. Pour plus d’informations, consultez délai de signature d’un assembly.
Notez qu’un projet signé différé n’est pas exécuté et ne peut pas être débogué. Vous pouvez toutefois utiliser l'Sn.exe (outil De nom fort) avec l’option -Vr pour ignorer la vérification pendant le développement.
Note
Lorsque vous signez un assembly, il se peut que vous n’ayez pas toujours accès à une clé privée. Par exemple, une organisation peut avoir une paire de clés étroitement protégée que les développeurs n’ont pas accès quotidiennement. La clé publique peut être disponible, mais l’accès à la clé privée est limité à quelques personnes. Dans ce cas, vous pouvez utiliser retard ou signature partielle pour fournir la clé publique, en reportant l’ajout de la clé privée jusqu’à ce que l’assembly soit remis.
Générer, paramètres avancés
Les options suivantes vous permettent de définir les paramètres de build avancés.
version du langage
Liens vers /langversion (options du compilateur C#), qui fournit des informations sur la façon dont une version de langage par défaut est choisie en fonction de l’infrastructure cible d’un projet.
Vérifier la de dépassement arithmétique
Spécifie si une instruction arithmétique entière qui n’est pas dans l’étendue du vérifié ou mots clés non vérifiés et qui entraîne une valeur en dehors de la plage du type de données entraîne une exception d’exécution. Pour plus d’informations, consultez /checked (Options du compilateur C#).
déterministe
Spécifie s’il faut produire une sortie équivalente d’octet pour octet à partir de la même source d’entrée. Pour plus d’informations, consultez options du compilateur C# qui contrôlent la génération de code.
rapport d’erreurs du compilateur interne
Spécifie s’il faut signaler des erreurs du compilateur à Microsoft. Si la valeur est définie sur invite (valeur par défaut), vous recevrez une invite si une erreur de compilateur interne se produit, ce qui vous permet d’envoyer un rapport d’erreurs électroniquement à Microsoft. Si la valeur est définie sur envoyer, un rapport d’erreur est envoyé automatiquement. Si la valeur est de file d’attente, les rapports d’erreurs sont mis en file d’attente. Si elle est définie sur aucune, l’erreur est signalée uniquement dans la sortie du texte du compilateur. Pour plus d’informations, consultez /errorreport (options du compilateur C#).
d’alignement des fichiers
Spécifie la taille des sections dans le fichier de sortie. Les valeurs valides sont 512, 1024, 2048, 4096et 8192. Ces valeurs sont mesurées en octets. Chaque section est alignée sur une limite qui est un multiple de cette valeur, affectant la taille du fichier de sortie. Pour plus d’informations, consultez /filealign (options du compilateur C#).
Package, Paramètres généraux
Les propriétés de cette section sont utilisées pour configurer des packages, généralement correspondant aux propriétés d’un fichier nuGet .nuspec. Pour plus d’informations, consultez fichier .nuspec.
Package, Paramètres de licence
de licence de package
Spécifie s’il faut inclure une expression de licence ou un fichier de licence dans votre package. Pour plus d’informations, consultez l’élément de licence .
Paramètres de package, symboles
Produire un package de symboles
Spécifie s’il faut créer un package de symboles pour le débogage. Pour plus d’informations, consultez Création de packages de symboles (.snupkg).
Analyse du code, tous les paramètres de l’analyseur
Exécuter sur le de build
Spécifie s’il faut exécuter l’analyse du code source lorsque vous générez le projet. Pour plus d’informations, consultez Désactiver l’analyse du code source pour .NET.
Exécuter sur des d’analyse en direct
Spécifie s’il faut exécuter l’analyse du code source en direct lorsque vous générez le projet. Pour plus d’informations, consultez Désactiver l’analyse du code source pour .NET.
Analyse du code, paramètres de l’analyseur .NET
Appliquer le style de code sur la build
Spécifie si les violations de style de code .NET sont signalées lors de la génération du projet. Pour plus d’informations, consultez Appliquer des styles de code sur la build.
activer les analyseurs .NET
Active ou désactive les analyseurs de plateforme de compilateur .NET (Roslyn). Pour plus d’informations, consultez Activer ou installer des analyseurs .NET internes.
niveau d’analyse
Spécifie le jeu d’analyseurs à exécuter dans le projet. Pour plus d’informations, consultez section Dernières mises à jour dans l’article vue d’ensemble de l’analyse du code.
Déboguer, paramètres généraux
Sélectionnez le lien pour ouvrir l’interface utilisateur des profils de lancement de débogage. Cette interface utilisateur vous permet d’ajouter et de configurer différents profils à utiliser lors du débogage. Chaque nom de profil apparaît sous la forme d’une option de démarrage dans la liste Démarrer le débogage.
Pour ASP.NET projets Principaux, les paramètres de l’interface utilisateur des profils de lancement correspondent aux paramètres du fichier launchSettings.json du projet. Pour plus d’informations sur l’utilisation de ce fichier dans ASP.NET développement, consultez Développement et launchSettings.json.
Ressources, paramètres généraux
Sélectionnez le lien pour ouvrir le fichier de ressources d’assembly RESX. Pour plus d’informations, consultez page Paramètres, Project Designer.
Voir aussi
de l’interface utilisateur des propriétés de projet repensées