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

この記事の情報は、.NET 5 以降に適用されます。 UWP プロジェクトについては、 UWP バージョンの選択に関する記事のこの情報を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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