C#-Compileroptionen

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

Festlegen von Optionen

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

• In Ihrer Datei "*.csproj"

  Sie können MSBuild-Eigenschaften für jede Compileroption in Der Datei *.csproj im XML-Format hinzufügen. Der Eigenschaftsname ist identisch mit 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 stellt Eigenschaftenseiten zum Bearbeiten von Buildeigenschaften bereit. Weitere Informationen hierzu finden Sie unter Verwalten von Projekt- und Lösungseigenschaften – Windows oder Verwalten von Projekt- und Lösungseigenschaften – Mac.

.NET Framework-Projekte

Von Bedeutung

Dieser Abschnitt gilt nur für .NET Framework-Projekte.

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

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

Das Wort für einige Compileroptionen wurde von 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 aufgeführt. Bei csc.exewerden alle Argumente nach der Option und einem Doppelpunkt aufgelistet. Die Option wäre beispielsweise -doc :

-doc:DocFile.xml

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

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

Wenn Sie die Entwickler-Eingabeaufforderung für Visual Studio verwenden, werden alle erforderlichen Umgebungsvariablen für Sie festgelegt. Informationen zum Zugriff auf dieses Tool finden Sie an der Entwickler-Eingabeaufforderung für Visual Studio.

Die csc.exe ausführbare Datei befindet sich in der Regel im Ordner Microsoft.NET\Framework\<Version> unter dem Windows-Verzeichnis . Der Standort kann abhängig von der genauen Konfiguration eines bestimmten Computers variieren. Wenn mehr als eine Version von .NET Framework auf Ihrem Computer installiert ist, finden Sie mehrere Versionen dieser Datei. Weitere Informationen zu solchen Installationen finden Sie unter How to: Determine which versions of the .NET Framework are installed.