C# バージョン別 演算子と初期化構文シンタックスシュガー一覧

概要

本記事では、.NET Framework 環境で ??=（ヌル合体割り当て演算子）が使用できないという問題を契機として、C# 各バージョンで追加された演算子および初期化の糖衣構文（シンタックスシュガー）をバージョン対応表とコード例を交えて網羅的に整理する。
対応するバージョンを事前に把握しておくことで、環境の制約に応じた適切な実装選択が可能となる。

前提・対象環境

• 言語: C# 1.0 〜 C# 12
• フレームワーク: .NET Framework 2.0〜4.8 / .NET Core / .NET 5〜8
• 対象機能: Null 安全演算子、インデックス・範囲演算子、型演算子、初期化の糖衣構文

問題

.NET Framework をターゲットにした C# 開発において、プロジェクトが C# 8.0 未満（例: 7.3）としてコンパイルされている場合、??=（ヌル合体割り当て演算子）を使用するとコンパイルエラーが発生する。

private List<int> _numbers;

public void AddNumber(int val)
{
    _numbers ??= new List<int>(); // C# 8.0 未満でコンパイルされる環境ではコンパイルエラー
    _numbers.Add(val);
}

このエラーは、??= が C# 8.0 で導入された構文である一方で、プロジェクトが C# 8.0 未満としてコンパイルされている（LangVersion が 7.3 以前など）ために発生する。

原因・背景

C# の言語バージョンはターゲットフレームワークとは独立しており、利用可否は主に (1) コンパイラ／LangVersion と、(2) 機能が要求するランタイム側の型・API の有無で決まる。
そのため .NET Framework をターゲットとしていても、ビルド環境が C# 8.0 に対応していれば ??= や ! のような言語機能は使用できる。

以下に、本記事で取り上げる演算子・構文と導入された C# バージョンの対応表を示す。
導入時期を時系列で見ると次のようになる。

• †1: 純粋な言語機能。LangVersion を対応する C# バージョンに設定（または Visual Studio / .NET SDK を更新）すれば .NET Framework 上でも使用できる。
• †2: System.Index / System.Range（.NET Core 3.0+ で追加された BCL 型）が必要。.NET Framework では System.Index（NuGet。System.Index / System.Range を提供）などで型を補うか、ポリフィルを自前で定義する必要がある。
• †3: System.Runtime.CompilerServices.RequiredMemberAttribute（.NET 7+ で追加された BCL 属性）が必要。.NET Framework では属性を自前で定義するか NuGet パッケージで補う必要がある。

解決方法

C# の新構文でコンパイルエラーが発生した場合の対処方法は、主に以下の 2 つである。

方法1：LangVersion を引き上げる（またはビルド環境を更新する）

プロジェクトファイル（.csproj）に <LangVersion> を明示的に指定することで、使用する C# バージョンを制御できる。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net481</TargetFramework>
    <LangVersion>8.0</LangVersion>  <!-- ??= や ! が使用可能になる -->
  </PropertyGroup>
</Project>

Visual Studio または .NET SDK を最新バージョンに更新することでも、対応する C# バージョンのコンパイラが利用可能になる。

方法2：旧構文に書き換える

ビルド環境を変更できない場合や、BCL 型が不足している場合（System.Index / System.Range など）は、同等の意味を持つ古い構文で代替する。

// ??= が使えない場合
_numbers = _numbers ?? new List<int>();

// ^ が使えない場合（System.Index が不足）
int last = array[array.Length - 1];

// .. が使えない場合（System.Range が不足）
int[] sliced = array.Skip(1).Take(3).ToArray();

上記はいずれも意味を保ったまま旧構文で表現した例である（LINQ 例は using System.Linq; が必要）。

実装例

1. Null 安全演算子

?. と ?[]（ヌル条件演算子）— C# 6.0 以降

オブジェクトまたはコレクションが null でない場合のみメンバーや要素にアクセスする。
対象が null であれば評価を行わず null を返すため、事前の null チェックを省略できる。

string title = GetTitle();
int? length = title?.Length; // title が null なら length も null になる

List<string> items = GetItems();
string firstItem = items?[0]; // items が null なら firstItem も null になる

?. と ?[] はメソッドチェーン中に組み合わせて使用できる。
いずれかの箇所で null が評価された時点でチェーン全体が null を返す。

??（ヌル合体演算子）— C# 2.0 以降

左辺の値が null でない場合はその値を、null である場合は右辺の値を返す。
null 時のデフォルト値を指定する際に使用される。

string typedName = GetName();
string displayName = typedName ?? "Anonymous"; // typedName が null なら "Anonymous" になる

?? は .NET Framework 2.0 以降でサポートされており、バージョンを問わず使用できる。

??=（ヌル合体割り当て演算子）— C# 8.0 以降

左辺の変数が null の場合にのみ右辺の値を代入する。
遅延初期化（Lazy Initialization）パターンで多用される。

private List<int> _numbers;

public void AddNumber(int val)
{
    _numbers ??= new List<int>(); // _numbers が null の時だけインスタンスを生成
    _numbers.Add(val);
}

ビルド環境が C# 8.0 未満（例: LangVersion が 7.3 以前）としてコンパイルされる場合、??= が使用できないため、?? を用いた以下の等価な記述で代替する。

_numbers = _numbers ?? new List<int>();

この書き方は ??= と同じく「null のときだけ代入する」意図を表すが、演算子が使える環境では ??= の方が簡潔である。

!（null 免除演算子）— C# 8.0 以降

C# の静的コード分析に対して「この変数はこの時点で絶対に null ではない」と宣言するための演算子である。
コンパイル時の Nullable 警告を抑制するためだけのものであり、実行時の挙動には一切影響を与えない。

string? rawInput = GetValidatedInput();
// 事前チェックにより、ここでは null にならないことが確定していると仮定
string solidInput = rawInput!;

! を使用すると null チェックが省略されるため、実際に null が渡された場合は実行時例外が発生する。
静的分析への過信は危険であり、使用箇所を最小限に抑えることが望ましい。

2. インデックスと範囲

^（末尾からのインデックス演算子）— C# 8.0 以降

コレクションの末尾からの位置を表す System.Index 型を生成する。
^1 は最後の要素（Length - 1）、^0 はコレクションの要素数（Length）と同じ位置を指す。

int[] digits = new[] { 10, 20, 30, 40 };
int last = digits[^1];         // 40（digits[digits.Length - 1] と等価）
int secondFromLast = digits[^2]; // 30

.NET Framework では System.Index 型が標準では提供されないため、追加参照／ポリフィルなしでは ^ 演算子を使用できない。
代替として array[array.Length - 1] のように明示的なインデックス計算を行う。

..（範囲演算子）— C# 8.0 以降

開始インデックスと終了インデックスを指定して部分範囲（System.Range）を生成し、配列や文字列のスライスを直感的に記述できる。
開始インデックスは含まれ、終了インデックスは含まれない（半開区間）。

int[] dataset = new[] { 0, 1, 2, 3, 4, 5 };
int[] sliced = dataset[1..4]; // [1, 2, 3]（インデックス 1 から 4 未満）

// 先頭・末尾の省略
int[] continuous = dataset[2..];  // インデックス 2 から末尾まで [2, 3, 4, 5]
int[] allButLast = dataset[..^1]; // 先頭から末尾の 1 つ前まで [0, 1, 2, 3, 4]

.. 演算子には System.Range 型が必要であり、.NET Framework では追加参照またはポリフィルなしに使用できない。
代替として array.Skip(start).Take(count).ToArray() のような LINQ を使用する方法がある。

3. 型演算子

is と as（型チェック・型キャスト演算子）

is はオブジェクトが特定の型と互換性があるかを判定する。
C# 7.0 以降ではパターンマッチングと組み合わせて、型が一致した場合に変数を宣言して代入できる。

as は型変換を試みて成功すればキャストされたオブジェクトを返し、失敗した場合は例外を発生させずに null を返す。

object element = "Hello WPF";

// is パターンマッチング（C# 7.0 以降）
if (element is string message)
{
    Console.WriteLine(message.Length); // このブロック内では string 型として扱える
}

// as 演算子
var stream = element as System.IO.Stream; // 変換できないため stream は null になる

(型名)obj の強制キャストは変換不可時に InvalidCastException を投げるのに対し、as は null を返すだけであるため、型の互換性が不確実な場合は as または is パターンマッチングを優先する。

4. データ操作・その他の演算子

=>（ラムダ演算子 / 式形式のメンバー）— C# 3.0 / C# 6.0 以降

C# 3.0 でラムダ式の構文として導入され、C# 6.0 ではプロパティやメソッドの定義を 1 行で記述する「式形式のメンバー（Expression-bodied members）」としても使用できるようになった。

public class Rectangle
{
    private readonly double _width;
    private readonly double _height;

    public Rectangle(double width, double height)
    {
        _width = width;
        _height = height;
    }

    // 式形式のプロパティ（C# 6.0）
    public double Area => _width * _height;

    // 式形式のメソッド（C# 6.0）
    public void PrintArea() => Console.WriteLine($"Area: {Area}");
}

式形式のメンバーは、処理が単一の式で表現できる場合にブロック本体を省略でき、クラス定義の可読性が向上する。

nameof（ネームオブ演算子）— C# 6.0 以降

変数、型、プロパティ、メソッドなどの識別子名をコンパイル時に文字列として取得する。
識別子名を文字列としてハードコードしないため、リファクタリング時の追随が自動化され、タイポを防止できる。

public void UpdateText(string? newText)
{
    if (newText == null)
    {
        // 引数名が変わっても nameof が自動的に追随する
        throw new ArgumentNullException(nameof(newText));
    }
}

nameof の戻り値はコンパイル時定数であるため、switch 文の case ラベルや属性の引数としても使用できる。

with（with 式）— C# 9.0 以降

レコード型（record）や構造体などの不変オブジェクトをベースに、一部のプロパティのみを変更した新しいコピーインスタンスを生成する。
元のオブジェクトは変更されない。

public record WindowSettings(string Title, double Width, double Height);

var defaultSettings = new WindowSettings("Main", 800, 600);
// Title と Width はそのまま引き継ぎ、Height のみ変更した新しいインスタンスを生成
var tallSettings = defaultSettings with { Height = 1000 };

with 式は C# 9.0 で導入された言語機能であり、LangVersion を C# 9.0 以上に設定することで .NET Framework 上でも使用可能である。
ただし record や init アクセサーを利用する場合、.NET Framework では System.Runtime.CompilerServices.IsExternalInit の追加定義（ポリフィル）が必要になることがある。

5. 初期化の糖衣構文

Target-typed new 式（ターゲット型の new 式）— C# 9.0 以降

代入先の型またはメソッドの引数の型からインスタンス化すべき型が推論できる場合、new の後ろの型名を省略して new() と記述できる。

public class Example
{
    public void Run()
    {
        // 以前の記述
        Dictionary<string, List<string>> map1 = new Dictionary<string, List<string>>();

        // Target-typed new
        Dictionary<string, List<string>> map2 = new();

        // メソッド引数への適用（型は引数から推論される）
        RegisterNumbers(new() { 1, 2, 3 });
    }

    private void RegisterNumbers(List<int> numbers) { }
}

型が左辺または引数の型宣言から明確に推論できる場合のみ省略可能である。
var と組み合わせると右辺の型が推論できなくなるため、var map = new(); のような記述はコンパイルエラーとなる。

コレクション式（Collection Expressions）— C# 12.0 以降

配列、List<T>、Span<T>、その他カスタムコレクションなど、あらゆるコレクションの初期化を [...] の統一した記法で記述できる。

int[] row = [1, 2, 3];                     // 配列
List<string> tags = ["C#", "WPF", ".NET"]; // List<T>
ReadOnlySpan<byte> data = [0x00, 0x01];    // Span<T>

コレクション式の中では .. スプレッド演算子を使用して、別のコレクションの要素をフラットに展開して結合できる。

int[] left = [1, 2];
int[] right = [5, 6];

int[] result = [.. left, 3, 4, .. right]; // [1, 2, 3, 4, 5, 6] が生成される

コレクション式は C# 12.0 で導入された構文であり、利用には C# 12.0 に対応したコンパイラ（LangVersion 12.0 以上）／SDK が必要である。

required プロパティ — C# 11.0 以降

required 修飾子を付与したプロパティは、オブジェクト初期化子によるインスタンス生成時に値の設定がコンパイルレベルで強制される。
コンストラクタの引数を追加せずに初期化漏れを防止できる。

public class AppTheme
{
    public required string ThemeName { get; init; } // 初期化時の指定が必須
    public string Author { get; init; } = "Unknown"; // 必須ではない（デフォルト値あり）
}

// コンパイル成功
var lightTheme = new AppTheme { ThemeName = "Light Mode" };

// コンパイルエラー（ThemeName が指定されていないため）
// var invalidTheme = new AppTheme { Author = "s-iguchi" };

required は C# 11.0 で導入された構文であり、.NET 7 以降では System.Runtime.CompilerServices.RequiredMemberAttribute が標準で提供される。
一方 .NET Framework など属性が存在しない環境では、属性の自前定義または追加参照（ポリフィル）が別途必要になる。

プライマリコンストラクタ — C# 12.0 以降

C# 12 から class や struct でもクラス名の後ろに直接コンストラクタの引数を定義できるようになった。
コンストラクタ本体の記述や、引数をプライベートフィールドに代入するだけの定型コードが不要になる。

public class LogWriter(string logFilePath, LogLevel minimumLevel)
{
    // 引数はクラス内の全メンバーから直接参照できる
    public void WriteLog(string message, LogLevel level)
    {
        if (level >= minimumLevel)
        {
            System.IO.File.AppendAllText(logFilePath, $"[{level}] {message}\n");
        }
    }
}

引数として渡された値（logFilePath や minimumLevel）は、クラス内のどのメンバーからも直接参照でき、パラメータの状態がそのまま維持される。
プライマリコンストラクタは C# 12.0 で導入された構文であり、利用には C# 12.0 に対応したコンパイラ（LangVersion 12.0 以上）／SDK が必要である。

注意点

• .NET Framework をターゲットにする場合でも、??= や ! のような言語機能はビルド環境（コンパイラ／LangVersion）が対応していれば使用できる。一方 ^ / ..（Index / Range）は必要な型・API（System.Index / System.Range など）の有無に依存するため、追加参照／ポリフィルが必要になるか、利用できない場合がある。
• !（null 免除演算子）はコンパイル時の警告を抑制するだけであり、実行時の null チェックを行わない。
  使用した箇所で null が渡された場合は NullReferenceException が発生するため、使用箇所を最小限に抑える。
• with 式、Target-typed new、コレクション式、プライマリコンストラクタは純粋な言語機能であり、LangVersion を対応バージョンに設定することで .NET Framework 上でも使用可能である。required は System.Runtime.CompilerServices.RequiredMemberAttribute が必要なため、追加参照または自前定義が別途必要になる。
• コレクション式の .. スプレッド演算子は、C# 8.0 の範囲演算子 .. と同じ記号を使用するが、用途が異なる（コレクション式の中での要素展開）。

代替案・比較

C# 新構文でコンパイルエラーが発生した場合の対処アプローチを比較する。

まとめ

C# の演算子と初期化構文は言語バージョンとともに段階的に追加されており、使用可能かどうかは主にコンパイラ（LangVersion）と、機能が要求するランタイム側の型・API の有無に依存する。

環境ごとの選択基準は以下のとおりである。

• .NET Framework 環境（コンパイラを更新しない場合）：??（C# 2.0）、?.（C# 6.0）、nameof（C# 6.0）、is パターンマッチング（C# 7.0）が上限の目安となる。^1 は array[array.Length - 1] に、.. は LINQ に置き換えて対処する。
• .NET Framework 環境（LangVersion を C# 8.0 以上に設定した場合）：??=、!、with、Target-typed new などの言語機能が追加で利用可能になる。^ / .. は System.Index / System.Range のポリフィルが別途必要。
• .NET 5〜6（C# 9〜10）：BCL 型も含めてすべての C# 9〜10 機能が使用可能になる。
• .NET 7（C# 11）以降：required プロパティが利用可能になる。
• .NET 8（C# 12）以降：コレクション式、プライマリコンストラクタが利用可能になる。

コンパイラ（LangVersion）とターゲットフレームワークの組み合わせを事前に確認したうえで、利用可能な構文を選択することが適切である。