Настройка версии языка C#

Сведения в этой статье относятся к .NET 5 и выше. Сведения о проектах UWP см. в статье о выборе версии UWP.

В Visual Studio параметр изменения языковой версии с помощью пользовательского интерфейса отключен, так как версия по умолчанию соответствует целевой платформе проекта (TFM). Эта конфигурация по умолчанию обеспечивает совместимость между языковыми функциями и поддержкой среды выполнения. Чтобы изменить версию языка в Visual Studio, измените целевую платформу проекта.

Например, изменение целевого объекта TFM (например, с .NET 6 на .NET 9) обновляет версию языка соответствующим образом с C# 10 до C# 13. Этот подход предотвращает проблемы совместимости среды выполнения и сводит к минимуму непредвиденные ошибки сборки из-за неподдерживаемых языковых функций.

Если вам нужна определенная языковая версия, которая отличается от выбранной автоматически, см. методы, приведенные в этой статье, чтобы переопределить параметры по умолчанию непосредственно в файле проекта.

Если необходимо явно указать версию C#, это можно сделать несколькими способами:

• Вручную измените файл проекта.
• задание языковой версии для нескольких проектов в подкаталоге;
• Настройте параметр компилятора LangVersion.

Версию языка можно задать в файле проекта. Файл проекта — это *.csproj файл в корневой папке проекта. Например, если вы явно хотите получить доступ к функциям предварительной версии, добавьте элемент, как показано в следующем примере:

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

Значение preview использует последнюю доступную предварительную версию языка C#, поддерживаемую вашим компилятором.

Чтобы настроить несколько проектов C#, можно создать файл Directory.Build.props , как правило, в каталоге решения, который содержит <LangVersion> элемент. Добавьте следующий параметр в файл Directory.Build.props :

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

Сборки во всех подкаталогах каталога, содержащего этот файл, теперь используют предварительную версию C#. Дополнительные сведения см. в статье Настройка сборки.

В следующей таблице показаны все текущие версии языка C#. Старые компиляторы могут не понимать каждое значение. Если установить последний пакет SDK для .NET, у вас есть доступ ко всем перечисленным.