Opcje kompilatora C#

W tej sekcji opisano opcje interpretowane przez kompilator języka C#. Opcje są pogrupowane w oddzielne artykuły w oparciu o elementy, które kontrolują, na przykład funkcje językowe, generowanie kodu i dane wyjściowe. Użyj spisu treści, aby poruszać się między nimi.

Jak ustawić opcje

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

  • W pliku *.csproj

    Możesz dodać MSBuild 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 kodu pliku projektu ustawia właściwość LangVersion .

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

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

  • Korzystanie ze stron Visual Studio właściwości

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

.NET Framework projektów

Ważne

Ta sekcja dotyczy tylko .NET Framework projektów.

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

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

Słowo niektórych opcji kompilatora zmieniło się zcsc.exe i .NET Framework projektu na nowy MSBuild systemu. Nowa składnia jest używana w tej sekcji. Obie wersje są wymienione w górnej części każdej strony. W csc.exeargumenty są wymienione po opcji i dwukropek. Na przykład ta opcja -doc będzie miała 2017:00:

-doc:DocFile.xml

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

W .NET Framework można również uruchamiać csc.exez wiersza polecenia. Każda opcja kompilatora jest dostępna w dwóch formach: -option i /option. W .NET Framework sieci Web należy określić opcje kompilowania kodu w pliku web.config. Aby uzyskać więcej informacji, zobacz element kompilatora>.

Jeśli używasz okna wiersz polecenia dla deweloperów dla Visual Studio, zostaną ustawione wszystkie niezbędne zmienne środowiskowe. Aby uzyskać informacje na temat uzyskiwania dostępu do tego narzędzia, zobacz wiersz polecenia dla deweloperów for Visual Studio.

Plik csc.exe wykonywalny zazwyczaj znajduje się w folderze Microsoft.NET\Framework\Version w Windows katalogu. Jego lokalizacja może się różnić w zależności od dokładnej konfiguracji określonego komputera. Jeśli na komputerze jest .NET Framework więcej niż jedną wersję aplikacji, znajdziesz wiele wersji tego pliku. Aby uzyskać więcej informacji na temat takich instalacji, zobacz Jak określić, które wersje .NET Framework zainstalowane.