Opzioni del compilatore C#

Questa sezione descrive le opzioni interpretate dal compilatore C#. Le opzioni sono raggruppate in articoli separati in base a ciò che controllano, ad esempio funzionalità del linguaggio, generazione di codice e output. Usare il sommario per spostarsi tra di essi.

Come impostare le opzioni

Esistono due modi diversi per impostare le opzioni del compilatore nei progetti .NET:

• Nel file *.csproj

  È possibile aggiungere proprietà MSBuild per qualsiasi opzione del compilatore nel file *.csproj in formato XML. Il nome della proprietà corrisponde all'opzione del compilatore. Il valore della proprietà imposta il valore dell'opzione del compilatore. Ad esempio, il frammento di file di progetto seguente imposta la LangVersion proprietà .

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

  Per altre informazioni sull'impostazione delle opzioni nei file di progetto, vedere l'articolo Proprietà di MSBuild per progetti .NET SDK.

• Utilizzo delle pagine delle proprietà di Visual Studio

  Visual Studio fornisce pagine delle proprietà per modificare le proprietà di compilazione. Per altre informazioni, vedere Gestire le proprietà del progetto e della soluzione - Windows o Gestire le proprietà del progetto e della soluzione - Mac.

Progetti .NET Framework

Importante

Questa sezione si applica solo ai progetti .NET Framework.

Oltre ai meccanismi descritti in precedenza, è possibile impostare le opzioni del compilatore usando due metodi aggiuntivi per i progetti .NET Framework:

• Argomenti della riga di comando per i progetti .NET Framework: i progetti .NET Framework usano dotnet build anziché per compilare progetti. È possibile specificare gli argomenti della riga di comando da csc.exe per i progetti .NET Framework.
• Pagine ASP.NET compilate: i progetti .NET Framework usano una sezione del file diweb.config per la compilazione delle pagine. Per il nuovo sistema di compilazione e ASP.NET progetti Core, le opzioni vengono ricavate dal file di progetto.

La parola per alcune opzioni del compilatore è cambiata da progetticsc.exe e .NET Framework al nuovo sistema MSBuild. La nuova sintassi viene usata in questa sezione. Entrambe le versioni sono elencate nella parte superiore di ogni pagina. Per csc.exe, tutti gli argomenti sono elencati dopo l'opzione e due punti. Ad esempio, l'opzione -doc sarà:

-doc:DocFile.xml

È possibile richiamare il compilatore C# digitando il nome del file eseguibile (csc.exe) al prompt dei comandi.

Per i progetti .NET Framework, è anche possibile eseguire csc.exe dalla riga di comando. Ogni opzione del compilatore è disponibile in due formati: -option e /option. Nei progetti Web .NET Framework è possibile specificare le opzioni per la compilazione del code-behind nel file web.config . Per altre informazioni, vedere <compiler> Elemento.

Se si usa la finestra Del prompt dei comandi per gli sviluppatori per Visual Studio , vengono impostate tutte le variabili di ambiente necessarie. Per informazioni su come accedere a questo strumento, vedere Prompt dei comandi per gli sviluppatori per Visual Studio.

Il file eseguibilecsc.exesi trova in genere nella cartella Microsoft.NET\Framework\<Version> nella directory di Windows . La posizione può variare a seconda della configurazione esatta di un determinato computer. Se nel computer sono installate più versioni di .NET Framework, sono disponibili più versioni di questo file. Per altre informazioni su tali installazioni, vedere Procedura: determinare le versioni di .NET Framework installate.