Options du compilateur C#

Cette section décrit les options interprétées par le compilateur C#. Les options sont regroupées en articles distincts en fonction de ce qu’ils contrôlent, par exemple, les fonctionnalités de langage, la génération de code et la sortie. Utilisez la table des matières pour naviguer entre eux.

Comment définir des options

Il existe deux façons de définir les options du compilateur dans les projets .NET :

• Dans votre fichier *.csproj

  Vous pouvez ajouter des propriétés MSBuild pour n’importe quelle option de compilateur dans votre fichier *.csproj au format XML. Le nom de la propriété est identique à l’option du compilateur. La valeur de la propriété définit la valeur de l’option du compilateur. Par exemple, l’extrait de code de fichier projet suivant définit la LangVersion propriété.

  <PropertyGroup>
    <LangVersion>preview</LangVersion>
  </PropertyGroup>
  

  Pour plus d’informations sur la définition d’options dans les fichiers projet, consultez l’article sur les propriétés MSBuild pour les projets sdk .NET.

• Utilisation des pages de propriétés Visual Studio

  Visual Studio fournit des pages de propriétés pour modifier les propriétés de build. Pour en savoir plus sur ces propriétés, consultez Gérer les propriétés du projet et de la solution - Windows ou Gérer des propriétés de projet et de solution - Mac.

Projets .NET Framework

Outre les mécanismes décrits ci-dessus, vous pouvez définir des options de compilateur à l’aide de deux méthodes supplémentaires pour les projets .NET Framework :

• Arguments de ligne de commande pour les projets .NET Framework : les projets .NET Framework utilisent csc.exe au lieu de générer des dotnet build projets. Vous pouvez spécifier des arguments de ligne de commande pour csc.exe pour les projets .NET Framework.
• Pages ASP.NET compilées : les projets .NET Framework utilisent une section du fichier web.config pour compiler des pages. Pour le nouveau système de build et ASP.NET projets Core, les options sont extraites du fichier projet.

Le mot pour certaines options du compilateur est passé des projets csc.exe et .NET Framework au nouveau système MSBuild. La nouvelle syntaxe est utilisée dans cette section. Les deux versions sont répertoriées en haut de chaque page. Pour csc.exe, tous les arguments sont répertoriés en suivant l’option et un signe deux-points. Par exemple, l’option -doc serait :

-doc:DocFile.xml

Vous pouvez appeler le compilateur C# en tapant le nom de son fichier exécutable (csc.exe) à l’invite de commandes.

Pour les projets .NET Framework, vous pouvez également exécuter csc.exe à partir de la ligne de commande. Chaque option du compilateur est disponible sous deux formes : -option et /option. Dans les projets web .NET Framework, vous spécifiez les options de compilation du code-behind dans le fichier web.config . Pour plus d’informations, consultez <l’élément du compilateur>.

Si vous utilisez la fenêtre Invite de commandes développeur pour Visual Studio , toutes les variables d’environnement nécessaires sont définies pour vous. Pour plus d’informations sur l’accès à cet outil, consultez l’invite de commandes développeur pour Visual Studio.

Le fichier exécutable csc.exe se trouve généralement dans le dossier Microsoft.NET\Framework\<Version> sous le répertoire Windows . Son emplacement peut varier en fonction de la configuration exacte d’un ordinateur particulier. Si plusieurs versions de .NET Framework sont installées sur votre ordinateur, vous trouverez plusieurs versions de ce fichier. Pour plus d’informations sur ces installations, consultez Guide pratique pour déterminer les versions du .NET Framework installées.