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 anger du 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 valfritt 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 egenskapssidorna i Visual Studio

  Visual Studio tillhandahå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

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 dotnet build för 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 web.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. Alternativet skulle till exempel -doc vara:

-doc:DocFile.xml

Du kan anropa C#-kompilatorn genom att skriva namnet på den körbara filen (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 att kompilera kod bakom i web.config-filen . Mer information finns i< kompilatorelement>.

Om du använder kommandotolken för utvecklare för Visual Studio 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 Windows-katalogen . Platsen kan variera beroende på den exakta konfigurationen av en viss dator. Om mer ä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 Så här avgör du vilka versioner av .NET Framework som är installerade.