Opcje kompilatora języka C#

W tej sekcji opisano opcje interpretowane przez kompilator języka C#. Opcje są pogrupowane w oddzielne artykuły na podstawie tego, co kontrolują, na przykład funkcje języka, generowanie kodu i dane wyjściowe. Użyj spisu treści, aby nawigować między nimi.

Jak ustawić opcje

Istnieją dwa różne sposoby ustawiania opcji kompilatora w projektach platformy .NET:

• W pliku *.csproj

  Właściwości programu MSBuild można dodać dla dowolnej opcji kompilatora w pliku *.csproj w formacie XML. Nazwa właściwości jest taka sama jak opcja kompilatora. Wartość właściwości ustawia wartość opcji kompilatora. Na przykład poniższy fragment pliku projektu ustawia LangVersion właściwość .

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

  Aby uzyskać więcej informacji na temat opcji ustawień w plikach projektu, zobacz artykuł MSBuild properties for .NET SDK Projects (Właściwości programu MSBuild dla projektów zestawu .NET SDK).

• Używanie stron właściwości programu Visual Studio

  Program Visual Studio udostępnia strony właściwości do edytowania właściwości kompilacji. Aby dowiedzieć się więcej o nich, zobacz Zarządzanie właściwościami projektu i rozwiązania — Windows lub Zarządzanie właściwościami projektu i rozwiązania — Mac.

Projekty programu .NET Framework

Ważne

Ta sekcja dotyczy tylko projektów .NET Framework.

Oprócz opisanych powyżej mechanizmów można ustawić opcje kompilatora przy użyciu dwóch dodatkowych metod dla projektów programu .NET Framework:

• Argumenty wiersza polecenia dla projektów .NET Framework: projekty .NET Framework używają csc.exe zamiast dotnet build kompilować projekty. Argumenty wiersza polecenia można określić, aby csc.exe dla projektów programu .NET Framework.
• Skompilowane strony ASP.NET: projekty programu .NET Framework używają sekcji pliku web.config do kompilowania stron. W przypadku nowego systemu kompilacji i projektów ASP.NET Core opcje są pobierane z pliku projektu.

Słowo dla niektórych opcji kompilatora zmieniło się z projektówcsc.exe i .NET Framework na nowy system MSBuild. Nowa składnia jest używana w tej sekcji. Obie wersje są wyświetlane w górnej części każdej strony. W przypadkucsc.exewszystkie argumenty są wyświetlane zgodnie z opcją i dwukropkiem. Na przykład -doc opcja to:

-doc:DocFile.xml

Kompilator języka C# można wywołać, wpisując nazwę jego pliku wykonywalnego (csc.exe) w wierszu polecenia.

W przypadku projektów programu .NET Framework można również uruchomić csc.exe z poziomu wiersza polecenia. Każda opcja kompilatora jest dostępna w dwóch formularzach: -option i /option. W projektach internetowych programu .NET Framework można określić opcje kompilowania kodu w pliku web.config . Aby uzyskać więcej informacji, zobacz <compiler> Element.

Jeśli używasz okna wiersza polecenia dla deweloperów dla programu Visual Studio , wszystkie niezbędne zmienne środowiskowe są ustawione dla Ciebie. Aby uzyskać informacje na temat uzyskiwania dostępu do tego narzędzia, zobacz Developer Command Prompt for Visual Studio (Wiersz polecenia dla deweloperów dla programu Visual Studio).

Plik wykonywalny csc.exe znajduje się zwykle w folderze Microsoft.NET\Framework\<Version> w katalogu systemu Windows . Jego lokalizacja może się różnić w zależności od dokładnej konfiguracji określonego komputera. Jeśli na komputerze jest zainstalowana więcej niż jedna wersja programu .NET Framework, znajdziesz wiele wersji tego pliku. Aby uzyskać więcej informacji na temat takich instalacji, zobacz How to: determine which versions of the .NET Framework are installed (Instrukcje: określanie, które wersje programu .NET Framework są zainstalowane).