C# 15のUnion Typesとは?従来のクラスやenumとの違い
C# 15では、新機能としてUnion Types(ユニオン型)が追加されました。
Union Typesは、複数の型のうち、あらかじめ定義したケース型のいずれかを表現する機能です。
例えば、犬・猫・鳥のいずれかを表す Pet 型を定義できます。
従来のC#では、複数の型をまとめるために object やインターフェース、抽象クラスなどを利用する方法がありました。
Union Typesでは、扱うケース型を明示できるだけでなく、switch 式によって各ケースが処理されているかをコンパイラが確認できます。
この記事では、C# 15のUnion Typesの基本や、従来のクラス・enumとの違い、利用する際の注意点について紹介します。
C# 15のUnion Typesとは?
Union Typesは、あらかじめ定義した複数のケース型のうち、いずれかを表現できる型です。
C# 15では、union キーワードを使って定義します。
例えば、犬・猫・鳥のいずれかを表す Pet 型は、次のように定義できます。
public record class Cat(string Name);
public record class Dog(string Name);
public record class Bird(string Name);
public union Pet(Cat, Dog, Bird);
この例では、Pet というUnion Typesに、次の3つのケース型を指定しています。
- Cat
- Dog
- Bird
定義したケース型からUnion Typesへの暗黙的な変換もサポートされています。
そのため、次のように値を代入できます。
Pet pet = new Dog("Rex");
Pet 型には、宣言したケース型の値を格納できます。
従来の object のように任意の型を無制限に受け入れるのではなく、扱うケース型を宣言によって明確にできる点が特徴です。
Union Typesの主な特徴
Union Typesには、主に次の特徴があります。
格納できるケース型を定義できる
Union Typesでは、格納する値のケース型を宣言時に指定します。
例えば、次のように定義した場合、
public union Pet(Cat, Dog, Bird);
Pet はCat・Dog・Birdをケース型として持つUnion Typesになります。
一方、object は文字列や数値など、さまざまな型の値を受け入れられます。
Union Typesではケース型が明示されるため、メソッドの引数や戻り値で、どのような種類の値を扱うのかを表現しやすくなります。
なお、ケース型の派生型など、暗黙的にケース型へ変換できる値も対象になる場合があります。必ず宣言した型と実際の値の実行時型が完全に一致する必要がある、という意味ではありません。
switch式の網羅性をチェックできる
Union Typesの大きな特徴の1つが、switch 式の網羅性チェックです。
例えば、次のように記述できます。
Pet pet = new Dog("Rex");
string name = pet switch
{
Dog d => d.Name,
Cat c => c.Name,
Bird b => b.Name,
};
この例では、Dog・Cat・Birdのすべてのケースを処理しています。
Union Typesでは、コンパイラが定義されているケース型を把握できるため、すべてのケースを処理しているかを確認できます。
ケース型を追加した場合にも、そのケースを処理していない switch 式について、コンパイラが警告を出せることが特徴です。
ただし、nullの扱いには注意が必要です。ケース型にnull許容型が含まれる場合や、Union Typesの内部値がnullになる可能性がある場合は、null のケースも考慮する必要があります。
継承関係のない型を組み合わせられる
Union Typesでは、必ずしも共通の親クラスを持つ型を指定する必要はありません。
例えば、文字列と数値を扱うUnion Typesも定義できます。
public union IntOrString(int, string);
このように、継承関係のない型を1つの型として扱える点も特徴です。
従来のクラスやenumとの違い
Union Typesと従来のC#の機能には、どのような違いがあるのでしょうか。
主な違いを比較します。
| 比較項目 | Union Types | クラス・抽象クラス | enum |
|---|---|---|---|
| 複数の型を表現 | 可能 | 継承などで可能 | 不可 |
| 扱う値 | 宣言したケース型 | インスタンス | 名前付き定数 |
| 共通の継承関係 | 不要 | 必要な場合がある | なし |
| ケースの網羅性チェック | 対応 | Closed Hierarchiesなどで対応 | 一般的な列挙値の網羅を完全には保証しない |
| 主な用途 | 複数の型のいずれかを表現 | 共通の振る舞いや状態を定義 | 固定された選択肢を表現 |
クラス・抽象クラスとの違い
従来のC#では、共通の親クラスやインターフェースを用意して、複数の型をまとめる方法があります。
例えば、次のような構成です。
public abstract class Pet
{
}
public class Cat : Pet
{
}
public class Dog : Pet
{
}
public class Bird : Pet
{
}
この方法では、Cat・Dog・Birdを共通のPet型として扱えます。
ただし、通常の抽象クラスやインターフェースでは、別のアセンブリから派生クラスや実装クラスを追加できるため、コンパイラがすべての派生型を把握できるとは限りません。
Union Typesでは、宣言時にケース型を明示するため、扱うケースの範囲を限定できます。また、共通の親クラスを持たない型も組み合わせられます。
なお、C# 15では closed 修飾子を使ったClosed Hierarchiesも追加されています。
Closed Hierarchiesは、クラスの直接の派生型を同じアセンブリ内に限定する機能です。これにより、コンパイラが既知の派生型を把握し、switch 式の網羅性を確認できます。
Union Typesは継承関係のない型もまとめられる一方、Closed Hierarchiesはクラスの継承関係を維持したまま、派生型の範囲を制限する機能です。
enumとの違い
enum は、あらかじめ定義した名前付きの定数を扱うための機能です。
例えば、注文の状態を表現する場合は次のように定義できます。
public enum OrderStatus
{
Pending,
Processing,
Completed,
Canceled
}
enumでは、注文の状態を表現できます。
一方、Union Typesでは、複数の異なる型の値を扱えます。
例えば、処理結果として成功情報またはエラー情報を返すようなケースです。
public record Success(string Message);
public record Failure(int ErrorCode);
public union Result(Success, Failure);
このように、状態を表す定数ではなく、それぞれ異なるデータを持つ型を組み合わせて表現できます。
Union Typesはどのような場面で使える?
Union Typesは、複数の異なる型のうち、いずれか1つを扱う必要がある場面で利用できます。
代表的な用途を紹介します。
処理結果とエラーを表現する
処理結果を返すメソッドでは、成功時と失敗時で異なる情報を返したい場合があります。
例えば、成功時にはメッセージ、失敗時にはエラーコードを返すケースです。
public record Success(string Message);
public record Failure(int ErrorCode);
public union Result(Success, Failure);
このように定義すると、戻り値として成功または失敗のいずれかを表現できます。
呼び出し側では、switch 式によってそれぞれのケースを処理できます。
Result result = new Success("処理が完了しました");
string message = result switch
{
Success success => success.Message,
Failure failure => $"エラーコード: {failure.ErrorCode}",
};
成功と失敗で異なるデータを持たせたい場合に利用できます。
複数の種類のメッセージを扱う
アプリケーションで複数種類のメッセージを処理する場合にも利用できます。
例えば、次のようなメッセージを考えます。
- ユーザー登録メッセージ
- ユーザー削除メッセージ
- ユーザー更新メッセージ
それぞれ異なるデータを持つ型として定義し、Union Typesでまとめることができます。
新しいメッセージの種類を追加した場合にも、switch 式の網羅性チェックによって、処理の追加漏れを発見しやすくなります。
共通の親クラスを持たない型をまとめる
既存のクラスや構造体を変更せずに、複数の型を1つの型として扱いたい場合にも利用できます。
例えば、数値と文字列を同じ引数で受け取りたい場合などです。
public union IntOrString(int, string);
共通の親クラスを作る必要がないため、既存の型を組み合わせやすくなります。
Union Typesを利用するための環境
Union TypesはC# 15で追加された機能です。
利用するには、C# 15に対応したコンパイラとランタイム環境が必要です。
主な対応環境は次のとおりです。
| 項目 | 対応環境 |
|---|---|
| C# | C# 15 |
| .NET SDK | .NET 11 SDK |
| .NET Runtime | .NET 11 |
| Visual Studio | C# 15に対応するVisual Studio 2026 |
C# 15は、.NET 11 SDKで net11.0 を対象とするプロジェクトの既定の言語バージョンです。
Union Typesを利用するために、通常は <LangVersion>preview</LangVersion> を指定する必要はありません。
ただし、Microsoft Learnでは、.NET 11 SDKはプレリリースとして案内されています。実際に利用する場合は、使用するSDKとVisual Studioの対応状況を確認してください。
Union Typesを利用する際の注意点
便利なUnion Typesですが、利用する際にはいくつか注意点があります。
default値はnullになる場合がある
C# 15のUnion Typesは、コンパイラによってstructとして生成されます。
そのため、通常のstructと同じように default で初期化できます。
ただし、生成されたUnion Typesでは、既定値の内部データがnullになります。
例えば、次のような状態です。
Pet pet = default;
Console.WriteLine(pet.Value is null); // True
この状態では、Dog・Cat・Birdのいずれにも該当しません。
そのため、switch 式でケース型をすべて列挙していても、nullを考慮しないと実行時に SwitchExpressionException が発生する可能性があります。
必要に応じて、次のように null のケースも追加します。
string name = pet switch
{
Dog d => d.Name,
Cat c => c.Name,
Bird b => b.Name,
null => "ペットが設定されていません"
};
特に、フィールドや配列要素としてUnion Typesを利用する場合は、既定値の状態にも注意が必要です。
値型のケースではボックス化が発生する
C#のUnion Typesは、通常の union 宣言の場合、コンパイラによってstructとして生成されます。
内部の値は object? として保持されるため、int などの値型をケース型に指定すると、値はボックス化されます。
例えば、次のようなUnion Typesです。
public union IntOrString(int, string);
この場合、int の値は内部でボックス化されます。
そのため、Union Typesを使うだけで、通常の型やコレクションよりも高速になるわけではありません。
大量の値を扱う場合や、パフォーマンスが重要な処理では、内部のデータ表現も考慮する必要があります。
recordと同じ機能を持つわけではない
Union Typesは、recordと同じものではありません。
Union Typesは、どのケース型の値を保持しているかを表現することを主な目的としています。
recordのような値の比較、複製、分解などの機能が自動的に追加されるわけではありません。
必要な機能がある場合は、用途に応じて追加のメンバーや処理を定義する必要があります。
まとめ
C# 15で追加されたUnion Typesは、複数のケース型のうち、いずれかの値を表現できる機能です。
従来の object や抽象クラスなどと比べて、扱うケース型を明確に定義できることが特徴です。
また、switch 式の網羅性チェックにも対応しているため、ケースの追加による処理漏れをコンパイル時に発見しやすくなります。
主なポイントは次のとおりです。
unionキーワードでUnion Typesを定義できる- 複数のケース型のいずれかを表現できる
- 共通の親クラスを持たない型も組み合わせられる
switch式の網羅性をコンパイラがチェックできる- 既定値の内部データがnullになる場合がある
- 値型のケースではボックス化が発生する
これまで複数の型をまとめるために object や抽象クラスを利用していた場合は、Union Typesも選択肢の1つになります。
