Concepteur de projets .NET (C#)

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 les projets .NET Framework et Visual Basic, 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) dans Explorateur de solutions. Ensuite, choisissez Projet>Propriétés dans la barre de menus. Le Concepteur de projet s’affiche.

Remarque

Dans cet article, il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains éléments de l’interface utilisateur Visual Studio. Il se peut que vous utilisiez une autre édition de Visual Studio ou d’autres paramètres d’environnement. Pour plus d’informations, consultez Personnaliser l’IDE.

Application, Paramètres généraux

Les options suivantes 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 selon le type de projet. Par exemple, pour un projet Application console, vous pouvez spécifier Application Windows, Application console ou 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 la façon d’accéder à cette propriété par programmation, consultez OutputType.

Framework cible

Spécifie la version de .NET ciblée 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 :

Remarque

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 le framework cible du projet, vous devez sélectionner manuellement les prérequis pour qu’ils correspondent au nouveau framework cible.

Pour plus d’informations, consultez Vue d’ensemble du ciblage des frameworks.

Système d’exploitation cible

Spécifie le système d’exploitation que le projet cible. Combiné au framework cible, cela génère un TF spécifique au système d’exploitation .NET 5+.

Objet de démarrage

Définit le point d’entrée à appeler quand l’application se charge. Cet objet est généralement défini sur le formulaire principal de votre application ou sur la procédure Main qui s’exécute quand l’application démarre. Comme les bibliothèques de classes n’ont pas de point d’entrée, la seule option disponible pour cette propriété est (Non défini).

Par défaut, dans un projet d’application WPF, cette option est (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 quand l’application démarre. Pour cela, ouvrez le fichier Application.xaml de votre projet et définissez la propriété StartupUri sur un fichier .xaml de votre projet, par exemple, Window1.xaml. Pour obtenir la liste des éléments racines valides, consultez StartupUri. Vous devez également définir une méthode public static void Main() dans une classe du projet. Cette classe s’affiche dans la liste Objet de démarrage comme nom_projet.nom_classe. 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 contient le manifeste de l’assembly. La modification de cette propriété modifie également la propriété Nom de sortie.

Vous pouvez également effectuer 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 la rubrique 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 à utiliser comme icône de votre programme. Cliquez sur le bouton Parcourir pour accéder à 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 Ressources vous aide à configurer les paramètres des ressources pour votre application. Par défaut, les options Icône et Manifeste sont activées. Cela vous permet de sélectionner votre propre icône ou différentes options de génération du 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 quand l’application s’exécute sur Windows sous contrôle de compte d’utilisateur (UAC). Cette option peut avoir les valeurs suivantes :

• Incorporer les paramètres par défaut dans le fichier manifeste. Prend en charge le fonctionnement standard de Visual Studio sur Windows, qui incorpore les informations de sécurité dans le fichier exécutable de l’application, en indiquant que requestedExecutionLevel doit être AsInvoker. Il s'agit de l'option par défaut.

• Créer une application sans fichier manifeste. Cette méthode est appelée virtualisation. Utilisez cette option pour la compatibilité avec les applications antérieures.

• Utilisez 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

Utilisations globales implicites

Active ou désactive les utilisations globales, 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 par 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.

Plateforme cible

Spécifie le processeur devant être ciblé par le fichier de sortie. Choisissez x86 pour tout processeur compatible Intel 32 bits ; choisissez x64 pour tout processeur compatible Intel 64 bits ; choisissez ARM pour les processeurs ARM ; ou choisissez Any CPU pour spécifier que tout processeur est acceptable. Any CPU est la valeur par défaut pour les projets, car elle permet l’exécution de l’application sur la plus large gamme de matériel.

Pour plus d’informations, consultez /platform (options du compilateur C#).

Nullable

Spécifie le contexte C# pouvant accepter la valeur Null à l’échelle du projet. Cette option d’interface utilisateur a été introduite dans Visual Studio 16.5 et n’est activée que pour les projets qui utilisent C# 8.0 ou version ultérieure.

Pour plus d’informations, consultez Contextes pouvant accepter la valeur Null.

Générer des informations sur l’assembly

Spécifie si les 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 unsafe

Autorise la compilation du code utilisant le mot clé unsafe. Pour plus d’informations, consultez /unsafe (options du compilateur C#).

Optimiser le code

Active ou désactive les optimisations effectuées par le compilateur pour réduire la taille de votre fichier de sortie, et le rendre plus rapide et plus efficace. Pour plus d’informations, consultez /optimize (options du compilateur C#).

Symboles de débogage

Indique 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 l’option du compilateur DebugType . Ce paramètre a les options suivantes :

• Aucune

  Spécifie que les informations de débogage ne doivent pas être générées.

• full

  Permet d’attacher un débogueur au programme en cours d’exécution.

• pdbonly

  Active le débogage du code source lorsque le programme est démarré dans le débogueur, mais affiche uniquement un assembleur quand le programme en cours d’exécution est attaché au débogueur.

• portable

  Génère un fichier .PDB, un fichier de symboles portable non spécifique à la plateforme qui fournit d’autres outils, notamment des débogueurs, des informations sur les éléments dans le fichier exécutable principal et la façon dont il a été produit. Pour plus d’informations, consultez PDB portable.

• embedded

  Incorpore les informations de symboles portables dans l’assembly. Aucun fichier .PDB externe n’est produit.

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 du processus de génération.

Niveau d’avertissement

Spécifie le niveau d’affichage 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 les numéros des avertissements par 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 les numéros des avertissements par une virgule ou un point-virgule.

Conseil

Si vous ne souhaitez pas que les avertissements de l’analyse du code soient considérés comme des erreurs, consultez la 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 pour le processus de génération.

Chemin de sortie de base

Spécifie l'emplacement des fichiers de sortie pour cette configuration de projet. Entrez le chemin de la sortie de la génération dans cette zone ou choisissez sur le bouton Parcourir pour spécifier un chemin. Ce chemin est relatif ; si vous entrez un chemin absolu, il sera enregistré comme relatif. Le chemin par défaut est bin\Debug ou bin\Release\.

Grâce aux configurations de build simplifiées, le système de projet détermine s’il faut générer une version Debug ou Release. Si vous cliquez sur la commande Générer dans le menu Déboguer (F5), la génération est placée dans l’emplacement de débogage, indépendamment du Chemin de sortie spécifié. Toutefois, avec la commande Générer du menu Générer, elle est placée dans l’emplacement spécifié. Pour plus d’informations, consultez Présentation des configurations de build.

Assembly de référence

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 la 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 des événements de build, 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 rogné

Spécifie si le découpage est activé pendant le processus de publication. Pour plus d’informations, consultez Les 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 l’assembly

Cochez cette case pour signer l’assembly et créer un fichier de clé de nom fort. Pour plus d’informations sur la signature d’assemblys à l’aide du Concepteur de projet, consultez Comment : 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 SDK Windows pour signer l’assembly. Pour plus d’informations sur Al.exe, consultez Comment : signer un assembly avec un nom fort.

Liste de fichiers de clé de nom fort

Permet de spécifier un fichier de clé de nom fort nouveau ou existant pour signer l’assembly. Sélectionnez <Parcourir…> pour sélectionner un fichier de clé existant.

Signe différé uniquement

Cochez cette case pour différer la signature. Pour plus d’informations, consultez Temporiser la signature d’un assembly.

Notez qu’un projet à signature différée ne s’exécute pas et ne peut pas être débogué. Toutefois, vous pouvez utiliser Sn.exe (Strong Name Tool) avec l’option -Vr pour ignorer l’étape de vérification pendant le développement.

Notes

Lorsque vous signez un assembly, vous pouvez ne pas avoir accès à une clé privée. Par exemple, une entreprise peut avoir une paire de clés protégées auxquelles les développeurs n’ont pas accès tous les jours. La clé publique peut être disponible, mais l’accès à la clé privée est limité à quelques personnes. Dans ce cas, vous pouvez utiliser la signature différée ou la signature partielle pour fournir la clé publique, en différant 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#), fournissant des informations sur la façon dont une version de langage par défaut est choisie en fonction du framework cible d’un projet.

Vérifier le dépassement arithmétique

Spécifie si une instruction arithmétique entière hors de portée des mots clés checked ou unchecked, dont la valeur n’est pas comprise dans la plage du type de données, doit provoquer la levée d’une exception à l’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 les erreurs du compilateur à Microsoft. Si la valeur est prompt (valeur par défaut), une invite s’affiche en cas d’erreur interne du compilateur, et vous donne la possibilité d’envoyer un rapport d’erreurs par voie électronique à Microsoft. Si la valeur est send, un rapport d’erreurs est envoyé automatiquement. Si la valeur est queue, les rapports d’erreurs sont mis en file attente. Si la valeur est none, l’erreur est signalée uniquement dans la sortie de texte du compilateur. Pour plus d’informations, consultez /errorreport (options du compilateur C#).

Alignement des fichiers

Spécifie la taille des sections dans le fichier de sortie. Les valeurs valides sont 512, 1024, 2048, 4096 et 8192. Ces valeurs sont mesurées en octets. Chaque section est alignée sur une limite qui est un multiple de cette valeur, affectant ainsi 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 le fichier .nuspec.

Package, Paramètres de licence

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 la 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 l’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 les 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 la section Dernières mises à jour de l’article de 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 de lancement du projet Paramètres.json. Pour plus d’informations sur l’utilisation de ce fichier dans ASP.NET développement, consultez Développement et lancement Paramètres.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 Paramètres page Concepteur de projets.

Voir aussi

Interface utilisateur des propriétés du projet remaniée