C# 言語バージョンの構成

C# のバージョンを明示的に指定する必要がある場合は、いくつかの方法で実行できます。

• プロジェクト ファイルを手動で編集します。
• サブディレクトリ内の複数のプロジェクトに対して言語バージョンを設定する。
• LangVersion コンパイラ オプションを設定する。

Visual Studio で別の C# バージョンを選択できない理由

Visual Studio では、既定のバージョンがプロジェクトのターゲット フレームワーク (TFM) に合わせて調整されているため、UI を使用して言語バージョンを変更するオプションが無効になる場合があります。 この既定の構成により、言語機能とランタイム サポート間の互換性が保証されます。

たとえば、ターゲット TFM (たとえば、.NET 6 から .NET 9) に変更すると、言語バージョンが C# 10 から C# 13 に適宜更新されます。 この方法では、ランタイムの互換性に関する問題を回避し、サポートされていない言語機能による予期しないビルド エラーを最小限に抑えます。

自動的に選択されたものとは異なる特定の言語バージョンが必要な場合は、以下の方法を参照して、プロジェクト ファイル内の既定の設定を直接オーバーライドしてください。

プロジェクト ファイルを編集する

プロジェクト ファイルで言語のバージョンを設定できます。 たとえば、プレビュー機能に明示的にアクセスしたい場合は、次のように要素を追加します。

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

値 preview では、コンパイラでサポートされている使用可能な最新のプレビュー C# 言語バージョンが使用されます。

複数のプロジェクトを構成する

複数のプロジェクトを構成するには、 要素を含む <LangVersion> ファイルを (通常はソリューション ディレクトリに) 作成します。 以下の設定を Directory.Build.props ファイルに追加します。:

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

そのファイルが含まれるディレクトリのすべてのサブディレクトリ内のビルドで、プレビュー C# バージョンが使用されるようになります。 詳細については、「ビルドのカスタマイズ」を参照してください。

C# 言語バージョン リファレンス

次の表では、現在のすべての C# 言語バージョンを示します。 古いコンパイラでは、すべての値が解釈されない場合があります。 最新の .NET SDK をインストールすると、一覧表示されているすべてにアクセスできます。