Options du compilateur C#

Cette section décrit les options interprétées par le compilateur C#. Les options sont regroupées dans des 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 parmi celles-ci.

Comment définir des options

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

  • Dans votre fichier *. csproj

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

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

    pour plus d’informations sur la définition des options dans les fichiers projet, consultez l’article MSBuild propriétés 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 à leur sujet, consultez gérer les propriétés d’un projet et d’une solution-Windows ou gérer les propriétés d’un projet et d’une solution-Mac.

projets .NET Framework

Important

cette section s’applique uniquement aux projets .NET Framework.

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

  • arguments de ligne de commande pour les projets .NET Framework : lesprojets .NET Framework utilisent csc.exe au lieu de générer des projets. vous pouvez spécifier des arguments de ligne de commande pour csc.exe pour les projets .NET Framework.
  • pages de ASP.NET compilées: les projets .NET Framework utilisent une section du fichier web.config pour la compilation des pages. pour le nouveau système de génération et les projets de ASP.NET Core, les options sont extraites du fichier projet.

le mot pour certaines options du compilateur a été modifié à partir de csc.exe et .NET Framework projets vers le nouveau système de 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 à la suite de l’option et du signe deux-points. Par exemple, l' -doc option est :

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

Si vous utilisez la fenêtre Invite de commandes développeur pour Visual Studio, toutes les variables d’environnement nécessaires sont définies automatiquement. Pour plus d’informations sur l’accès à cet outil, consultez 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 de l’ordinateur utilisé. si plus d’une version de .NET Framework est installée 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 installées du .NET Framework.