C#-Compileroptionen

In diesem Abschnitt werden die vom C#-Compiler interpretierten Optionen beschrieben. Optionen werden in separaten Artikeln gruppiert, basierend darauf, was sie steuern, wie z. B. Sprachfeatures, Codegenerierung und Ausgabe. Verwenden Sie das Inhaltsverzeichnis, um zwischen diesen zu navigieren.

Möglichkeiten zum Festlegen von Optionen

Es gibt zwei verschiedene Möglichkeiten zum Festlegen von Compileroptionen in .NET-Projekten:

• In Ihrer CSPROJ-Datei

  Sie können MSBuild-Eigenschaften für jede Compileroption in Ihrer CSPROJ-Datei im XML-Format hinzufügen. Der Eigenschaftsname ist derselbe wie der Name der Compileroption. Der Wert der Eigenschaft legt den Wert der Compileroption fest. Der folgende Projektdateiausschnitt legt beispielsweise die LangVersion-Eigenschaft fest.

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

  Weitere Informationen zum Festlegen von Optionen in Projektdateien finden Sie im Artikel MSBuild-Eigenschaften für .NET SDK-Projekte.

• Verwenden der Visual Studio Eigenschaftenseiten

  Visual Studio bietet Eigenschaftenseiten zum Bearbeiten von Buildeigenschaften. Weitere Informationen dazu finden Sie unter Verwalten von Projekt- und Projektmappeneigenschaften: Windows oder Verwalten von Projekt- und Projektmappeneigenschaften: Mac.

.NET Framework-Projekte

Zusätzlich zu den oben beschriebenen Mechanismen können Sie Compileroptionen mithilfe von zwei zusätzlichen Methoden für .NET Framework-Projekte festlegen:

• Befehlszeilenargumente für .NET Framework-Projekte: In .NET Framework-Projekten wird csc.exe anstelle von dotnet build verwendet, um Projekte zu erstellen. Sie können Befehlszeilenargumente für csc.exe für .NET Framework-Projekte angeben.
• Kompilierte ASP.NET-Seiten: .NET Framework-Projekte verwenden einen Abschnitt der Datei web.config zum Kompilieren von Seiten. Für das neue Buildsystem und ASP.NET Core-Projekte werden Optionen aus der Projektdatei entnommen.

Die Bezeichnung für einige Compileroptionen hat sich aus csc.exe und .NET Framework-Projekten in das neue MSBuild-System geändert. Die neue Syntax wird in diesem Abschnitt verwendet. Beide Versionen werden oben auf jeder Seite aufgelistet. Für csc.exe werden alle Argumente nach der Option und einem Doppelpunkt aufgelistet. Die -doc-Option wäre beispielsweise:

-doc:DocFile.xml

Sie können den C#-Compiler aufrufen, indem Sie den Namen seiner ausführbaren Datei (csc.exe) in der Befehlszeile eingeben.

Für .NET Framework-Projekte können Sie csc.exe auch über die Befehlszeile ausführen. Jede Compileroption ist in zwei Varianten verfügbar: -option und /option. In .NET Framework-Webprojekten geben Sie Optionen für die Kompilierung von Code Behind in der Datei web.config an. Weitere Informationen finden Sie unter <compiler>-Element.

Wenn Sie das Fenster Developer-Eingabeaufforderung für Visual Studio verwenden, werden alle erforderlichen Umgebungsvariablen für Sie festgelegt. Weitere Informationen zum Zugreifen auf dieses Tool finden Sie unter Developer-Eingabeaufforderung für Visual Studio.

Die ausführbare Datei csc.exe befindet sich in der Regel im Windows-Verzeichnis im Ordner „Microsoft.NET\Framework\<Version>“. Der Speicherort unterscheidet sich je nach Konfiguration auf den einzelnen Computern. Wenn mehrere Versionen von .NET Framework auf dem Computer installiert sind, sind auch mehrere Versionen dieser Datei vorhanden. Weitere Informationen zu dieser Art von Installation finden Sie unter How to: determine which versions of the .NET Framework are installed (Vorgehensweise: Bestimmen der installierten .NET Framework-Version).