C#-kompilatoralternativ
I det här avsnittet beskrivs de alternativ som tolkas av C#-kompilatorn. Alternativen grupperas i separata artiklar baserat på vad de styr, till exempel språkfunktioner, kodgenerering och utdata. Använd innehållsförteckningen för att navigera bland dem.
Så här ställer du in alternativ
Det finns två olika sätt att ange kompilatoralternativ i .NET-projekt:
I filen *.csproj
Du kan lägga till MSBuild-egenskaper för alla kompilatoralternativ i filen *.csproj i XML-format. Egenskapsnamnet är samma som kompilatoralternativet. Värdet för egenskapen anger värdet för kompilatoralternativet. Följande projektfilfragment anger
LangVersion
till exempel egenskapen .<PropertyGroup> <LangVersion>preview</LangVersion> </PropertyGroup>
Mer information om hur du anger alternativ i projektfiler finns i artikeln MSBuild-egenskaper för .NET SDK Projects.
Använda Visual Studio egenskapssidor
Visual Studio innehåller egenskapssidor för att redigera byggegenskaper. Mer information om dem finns i Hantera projekt- och lösningsegenskaper – Windows eller Hantera projekt- och lösningsegenskaper – Mac.
.NET Framework projekt
Viktigt
Det här avsnittet gäller endast för .NET Framework projekt.
Förutom de mekanismer som beskrivs ovan kan du ange kompilatoralternativ med två ytterligare metoder för .NET Framework projekt:
- Kommandoradsargument för .NET Framework projekt: .NET Framework projekt använder csc.exe i stället för
dotnet build
att skapa projekt. Du kan ange kommandoradsargument för att csc.exe för .NET Framework projekt. - Kompilerade ASP.NET sidor: .NET Framework projekt använder ett avsnitt i denweb.config filen för att kompilera sidor. För det nya byggsystemet och ASP.NET Core projekt hämtas alternativen från projektfilen.
Ordet för vissa kompilatoralternativ har ändrats från csc.exe och .NET Framework projekt till det nya MSBuild-systemet. Den nya syntaxen används i hela det här avsnittet. Båda versionerna visas överst på varje sida. För csc.exevisas alla argument som följer alternativet och ett kolon. Till exempel skulle alternativet -doc
vara:
-doc:DocFile.xml
Du kan anropa C#-kompilatorn genom att skriva namnet på dess körbara fil (csc.exe) i en kommandotolk.
För .NET Framework projekt kan du också köra csc.exe från kommandoraden. Varje kompilatoralternativ är tillgängligt i två former: -option och /option. I .NET Framework webbprojekt anger du alternativ för kompilering av bakomliggande kod i web.config-filen. Mer information finns i <kompilatorelement>.
Om du använder kommandotolken för utvecklare för Visual Studio fönster anges alla nödvändiga miljövariabler åt dig. Information om hur du kommer åt det här verktyget finns i Kommandotolken för utvecklare för Visual Studio.
Den csc.exe körbara filen finns vanligtvis i mappen Microsoft.NET\Framework\<Version> under katalogen Windows. Dess plats kan variera beroende på den exakta konfigurationen av en viss dator. Om fler än en version av .NET Framework är installerad på datorn hittar du flera versioner av den här filen. Mer information om sådana installationer finns i How to: determine which versions of the .NET Framework are installed.