Поделиться через


Параметры компилятора C#

В этом разделе описаны параметры, интерпретируемые компилятором C#. Параметры сгруппированы в отдельные статьи в зависимости от того, чем они управляют. Это могут быть, например, функции языка, создание кода и выходные данные. Для навигации по параметрам можно воспользоваться оглавлением.

Установка параметров

В проектах .NET параметры компилятора можно задать двумя способами:

  • В файле *. csproj

    можно добавить свойства MSBuild для любого параметра компилятора в файле *. csproj в формате XML. Имя свойства совпадает с именем параметра компилятора. Значение свойства задает значение параметра компилятора. Например, в следующем фрагменте файла проекта задается свойство LangVersion.

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

    Дополнительные сведения о настройке параметров в файлах проекта см. в статье Справочник по MSBuild для проектов пакета SDK для .NET.

  • Использование страниц свойств Visual Studio

    В Visual Studio доступны страницы свойств, на которых можно изменять свойства сборки. Дополнительные сведения см. в статье Управление свойствами проектов и решений (Windows) или Управление свойствами проектов и решений (Mac).

Проекты .NET Framework

Важно!

Этот раздел относится только к проектам .NET Framework.

Кроме описанных выше способов, для проектов .NET Framework можно задать параметры компилятора с помощью двух дополнительных методов:

  • аргументы командной строки для проектов платформа .NET Framework: платформа .NET Framework проекты используют csc.exe , а не для сборки проектов. Аргументы командной строки можно указать в csc.exe для проектов .NET Framework.
  • Скомпилированные страницы ASP.NET. Проекты .NET Framework используют раздел файла web.config для компиляции страниц. Для новой системы сборки и проектов ASP.NET Core параметры берутся из файла проекта.

Некоторые параметры компилятора больше не используются в формате для csc.exe и проектов .NET Framework. Они используются в формате для новой системы MSBuild. В этом разделе применяется новый синтаксис. Обе версии приведены в верхней части каждой страницы. Для csc.exe все аргументы указываются после параметра и двоеточия. Например, параметр -doc будет выглядеть так:

-doc:DocFile.xml

Чтобы вызвать компилятор C#, следует ввести имя соответствующего исполняемого файла (csc.exe) в командной строке.

Кроме того, для проектов .NET Framework csc.exe можно запустить из командной строки. Каждый параметр компилятора можно использовать в двух формах записи: -параметр или /параметр. В проектах .NET Framework параметры для компиляции кода программной части указываются в файле web.config. Дополнительные сведения см. в разделе элемент компилятора >.

Если используется окно Командная строка разработчика для Visual Studio, все необходимые переменные среды устанавливаются автоматически. Дополнительные сведения о получении доступа к этому инструменту см. в статье Командная строка разработчика и PowerShell для разработчиков.

csc.exe исполняемый файл обычно находится в папке Microsoft. нет\фрамеворк\ Version в каталоге Windows . Расположение файла может зависеть от конкретной конфигурации компьютера. Если на компьютере установлено несколько версий .NET Framework, будет несколько версий этого файла. Дополнительные сведения о подобных вариантах установки см. в разделе Практическое руководство. Определение установленных версий платформы .NET Framework.