【C#】LINQで発生する例外の原因と安全なエラーハンドリング実践テクニック
LINQでは要素取得系のFirst
やSingle
が条件不一致でInvalidOperationException
を投げ、並列実行ではAggregateException
がまとめて返ります。
FirstOrDefault
など安全版を選び、try -catch
で型ごとに拾い、null確認やTryParse
で事前防御することが安定動作の鍵です。
LINQで例外が発生する仕組み
LINQ(Language Integrated Query)は、C#における強力なデータ操作ツールですが、使い方によっては例外が発生しやすい特徴があります。
LINQの例外発生の仕組みを理解することは、安全で堅牢なコードを書くうえで非常に重要です。
ここでは、LINQにおける例外発生のメカニズムを「遅延実行と即時実行の違い」「イテレーション時に発生する例外タイミング」「クエリ構築時のコンパイルエラーとの相違点」の3つの観点から詳しく解説します。
遅延実行と即時実行の違い
LINQの特徴の一つに「遅延実行(Deferred Execution)」があります。
これは、LINQクエリが定義された時点では実際のデータ処理は行われず、クエリの結果が必要になったタイミングで初めて処理が実行される仕組みです。
これに対して、即時実行(Immediate Execution)は、クエリが定義された直後に処理が実行され、結果がすぐに返される方式です。
遅延実行の例
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int> numbers = new List<int> { 1, 2, 3, 4, 5 };
// クエリの定義(まだ実行されていない)
var query = numbers.Where(n => n > 3);
// 元のリストに変更を加える
numbers.Add(6);
// クエリの実行(ここで初めて処理が行われる)
foreach (var num in query)
{
Console.WriteLine(num);
}
}
}
4
5
6
この例では、query
の定義時点では処理は行われず、numbers
に6を追加した後にクエリを実行しています。
遅延実行のため、最新のデータが反映されていることがわかります。
即時実行の例
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int> numbers = new List<int> { 1, 2, 3, 4, 5 };
// 即時実行メソッド ToList() を使って結果を取得
var result = numbers.Where(n => n > 3).ToList();
// 元のリストに変更を加える
numbers.Add(6);
// 既に取得済みの結果を表示
foreach (var num in result)
{
Console.WriteLine(num);
}
}
}
4
5
ToList()
を使うことでクエリが即時実行され、結果がリストとして取得されます。
そのため、後からnumbers
に6を追加してもresult
には反映されません。
例外発生の観点
遅延実行の場合、例外はクエリの実行時(イテレーション時)に発生します。
つまり、クエリを定義しただけでは例外は起きず、foreach
やToList()
などで実際にデータを取得しようとしたときに例外がスローされます。
一方、即時実行メソッドを使うと、クエリ定義直後に例外が発生する可能性があります。
この違いを理解していないと、例外がどのタイミングで発生するのか予測できず、デバッグが難しくなることがあります。
イテレーション時に発生する例外タイミング
LINQの遅延実行により、例外は主にイテレーション(列挙)時に発生します。
イテレーションとは、foreach
文やToList()
、Count()
などのメソッドでシーケンスの要素を順に取得する処理のことです。
例外が発生しやすいタイミング
- データソースがnullの場合
クエリの実行時にデータソースがnull
だと、NullReferenceException
が発生します。
これはイテレーション時に初めてデータソースにアクセスするためです。
- 条件に合致する要素が存在しない場合
First()
やSingle()
などのメソッドは、条件に合う要素がないとInvalidOperationException
をスローします。
これもイテレーション時に判定されます。
- インデックスが範囲外の場合
ElementAt()
で指定したインデックスがシーケンスの範囲外だと、ArgumentOutOfRangeException
が発生します。
これもイテレーション時のアクセス時に起きます。
- 型変換エラー
Cast<T>()
やSelect()
での変換処理中に不正な型が混入していると、InvalidCastException
が発生します。
これもイテレーション時に検出されます。
イテレーション時例外のサンプル
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<string> data = new List<string> { "hello", null, "world" };
try
{
var query = data.Where(s => s.Length > 0);
foreach (var item in query)
{
Console.WriteLine(item);
}
}
catch (NullReferenceException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: オブジェクト参照がオブジェクト インスタンスに設定されていません。
このように、LINQクエリの定義時には例外が発生せず、イテレーション時に初めて例外がスローされることが多いです。
クエリ構築時のコンパイルエラーとの相違点
LINQの例外発生は大きく分けて「コンパイル時エラー」と「実行時例外」に分かれます。
ここでは、クエリ構築時のコンパイルエラーと実行時に発生する例外の違いを説明します。
クエリ構築時のコンパイルエラー
LINQクエリの構文や型が正しくない場合、コンパイル時にエラーが発生します。
例えば、存在しないプロパティを参照したり、型が合わないラムダ式を渡した場合です。
using System;
using System.Collections.Generic;
using System.Linq;
class Person
{
public string Name { get; set; }
}
class Program
{
static void Main()
{
List<Person> people = new List<Person>
{
new Person { Name = "Alice" },
new Person { Name = "Bob" }
};
// コンパイルエラー: 'Age' は 'Person' に存在しない
var query = people.Where(p => p.Age > 20);
}
}
Console.cs(18,41): error CS1061: 'Person' に 'Age' の定義が含まれておらず、型 'Person' の最初の引数を受け付けるアクセス可能な拡張メソッド 'Age' が見つかりませんでした。using ディレクティブまたはアセンブリ参照が不足していないことを
確認してください [c:\Users\eliel\Documents\blog\GeekBlocks\csharp\Sample Console\Sample Console.csproj]
このコードはp.Age
がPerson
クラスに存在しないため、コンパイルエラーになります。
こうしたエラーは実行前に検出されるため、早期に修正可能です。
実行時例外との違い
一方、LINQの実行時例外は、クエリが正しく構築されていても、実行時のデータ状態や条件によって発生します。
例えば、First()
で要素が存在しない場合や、null
参照が混入している場合などです。
実行時例外はコンパイル時には検出できないため、適切な例外処理や事前チェックが必要です。
項目 | クエリ構築時のコンパイルエラー | 実行時例外 |
---|---|---|
発生タイミング | コンパイル時 | クエリ実行時(イテレーション時) |
原因 | 構文エラー、型不一致、存在しないメンバ参照 | データ不整合、条件不一致、null参照 |
対処方法 | コード修正、型定義の見直し | 例外処理、事前チェック、データ検証 |
例 | 存在しないプロパティ参照 | InvalidOperationException など |
この違いを理解しておくことで、LINQの例外発生箇所を正確に把握し、適切な対策を講じることができます。
特に遅延実行の特性を踏まえ、実行時例外の発生タイミングを意識した設計が重要です。
代表的な例外クラス一覧
LINQを使う際に遭遇しやすい例外クラスを具体的に解説します。
各例外の発生原因や典型的なケースを理解し、適切な対処を行うことが重要です。
InvalidOperationException
InvalidOperationException
は、LINQで最も頻繁に発生する例外の一つです。
主に、要素の存在条件が満たされない場合や、操作が不正な状態で行われたときにスローされます。
First / Single / Last 系メソッドの要素不在
First()
, Single()
, Last()
などのメソッドは、条件に合致する要素が存在しない場合にInvalidOperationException
をスローします。
例えば、空のシーケンスに対してFirst()
を呼び出すと例外が発生します。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int> numbers = new List<int>();
try
{
// 空のリストに対してFirst()を呼び出すと例外が発生
int first = numbers.First();
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: シーケンスに要素が含まれていません。
Single()
はさらに厳しく、要素が1つもない場合だけでなく、複数存在する場合にも例外をスローします。
List<int> numbers = new List<int> { 1, 2 };
try
{
int single = numbers.Single();
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
例外発生: シーケンスに複数の要素が含まれています。
Distinct や OrderBy でのキー重複
Distinct()
やOrderBy()
自体はキーの重複で例外をスローしませんが、DistinctBy()
(.NET 6以降)やカスタムの比較子を使う場合に、キーの重複が原因で例外が発生することがあります。
特に、OrderBy
のキーセレクターでnull
が返されると、比較時にInvalidOperationException
が起きることがあります。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
class Item
{
public string? Key { get; set; }
}
static void Main()
{
var items = new List<Item>
{
new Item { Key = "A" },
new Item { Key = null },
new Item { Key = "B" }
};
try
{
// nullキーがあるためOrderByで例外が発生する可能性がある
var ordered = items.OrderBy(i => i.Key).ToList();
foreach (var item in ordered)
{
Console.WriteLine(item.Key ?? "null");
}
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
null
A
B
上記の例では例外は発生しませんが、カスタム比較子や特定の状況でnull
キーが原因の例外が起きることがあるため注意が必要です。
ArgumentNullException
ArgumentNullException
は、メソッドにnull
が渡された場合に発生します。
LINQでは、データソースやラムダ式がnull
の場合に多く見られます。
データソースが null の場合
LINQメソッドにnull
のシーケンスを渡すと、ArgumentNullException
がスローされます。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int>? numbers = null;
try
{
var result = numbers.Where(n => n > 0);
}
catch (ArgumentNullException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: 値は null であってはなりません。 (パラメーター名: source)
プロジェクション内の null 参照
Select
やWhere
のラムダ式内でnull
参照を操作しようとすると、ArgumentNullException
やNullReferenceException
が発生します。
例えば、null
のオブジェクトのプロパティにアクセスしようとした場合です。
using System;
using System.Collections.Generic;
using System.Linq;
class Person
{
public string? Name { get; set; }
}
class Program
{
static void Main()
{
var people = new List<Person?>
{
new Person { Name = "Alice" },
null,
new Person { Name = "Bob" }
};
try
{
var names = people.Select(p => p.Name).ToList();
foreach (var name in names)
{
Console.WriteLine(name);
}
}
catch (NullReferenceException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: Object reference not set to an instance of an object.
この例ではnull
の要素があるため、p.Name
のアクセスでNullReferenceException
が発生する可能性があります。
安全に処理するにはWhere(p => p != null)
などのフィルターが必要です。
ArgumentException
ArgumentException
は、メソッドに渡された引数が不正な場合に発生します。
LINQでは、ラムダ式のパラメータが不正だったり、無効な操作を行った場合に起きます。
ラムダ式の不正なパラメータ
例えば、OrderBy
のキーセレクターで不正なラムダ式を渡すとArgumentException
が発生します。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int> { 1, 2, 3 };
try
{
// ラムダ式のパラメータにnullを渡す
Func<int, int>? keySelector = null;
var ordered = numbers.OrderBy(keySelector).ToList();
}
catch (ArgumentNullException ex) // 派生クラスを先にキャッチ
{
Console.WriteLine($"例外発生: {ex.Message}");
}
catch (ArgumentException ex) // 基底クラスは後にキャッチ
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: Value cannot be null. (Parameter 'keySelector')
この例ではArgumentNullException
が発生していますが、ラムダ式の不正な内容によってはArgumentException
がスローされることもあります。
ArgumentOutOfRangeException
ArgumentOutOfRangeException
は、引数が許容範囲外の場合に発生します。
LINQでは、ElementAt()
メソッドで指定したインデックスがシーケンスの範囲外のときに発生します。
ElementAt のインデックス超過
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int> { 10, 20, 30 };
try
{
// インデックス3は存在しないため例外が発生
int value = numbers.ElementAt(3);
}
catch (ArgumentOutOfRangeException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
ElementAtOrDefault()
を使うと、範囲外の場合はデフォルト値が返るため例外は発生しません。
AggregateException
AggregateException
は、PLINQ(Parallel LINQ)などの並列処理で複数の例外が同時に発生した場合に、それらをまとめてスローする例外です。
PLINQ で発生する複数例外の集約
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
class Program
{
static void Main()
{
var numbers = Enumerable.Range(1, 10);
try
{
var query = numbers.AsParallel().Select(n =>
{
if (n % 3 == 0)
throw new InvalidOperationException($"無効な操作: {n}");
return n;
});
foreach (var num in query)
{
Console.WriteLine(num);
}
}
catch (AggregateException ex)
{
foreach (var inner in ex.InnerExceptions)
{
Console.WriteLine($"例外発生: {inner.Message}");
}
}
}
}
1
2
4
5
7
8
10
例外発生: 無効な操作: 3
例外発生: 無効な操作: 6
例外発生: 無効な操作: 9
複数のスレッドで例外が発生すると、AggregateException
にまとめられます。
InnerExceptions
を展開して個別に処理することが推奨されます。
FormatException
FormatException
は、文字列の形式が不正な場合に発生します。
LINQの中で文字列を数値や日付に変換する際に起こりやすいです。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var strings = new List<string> { "100", "abc", "200" };
try
{
var numbers = strings.Select(s => int.Parse(s)).ToList();
}
catch (FormatException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: The input string 'abc' was not in a correct format.
int.TryParse
を使うことで安全に変換できます。
OverflowException
OverflowException
は、数値の範囲を超えた演算や変換で発生します。
LINQの集計や変換処理で大きな値を扱う場合に注意が必要です。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int> { int.MaxValue, 1 };
try
{
var sum = numbers.Select(n => checked(n + 1)).ToList();
}
catch (OverflowException ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
例外発生: Arithmetic operation resulted in an overflow.
checked
キーワードを使うことでオーバーフロー検出が可能です。
外部ソース固有の例外
LINQはデータベースやファイルなど外部ソースと連携することが多いため、SqlException
などのI/O由来の例外も発生します。
これらはLINQ自体の例外ではありませんが、LINQクエリの実行時に発生することがあるため注意が必要です。
SqlException など I/O 由来のケース
using System;
using System.Data.SqlClient;
using System.Linq;
class Program
{
static void Main()
{
try
{
// 例示的に接続文字列が不正な場合
using var connection = new SqlConnection("InvalidConnectionString");
connection.Open();
var command = connection.CreateCommand();
command.CommandText = "SELECT * FROM NonExistentTable";
var reader = command.ExecuteReader();
var query = reader.Cast<System.Data.Common.DbDataRecord>().Select(r => r[0]);
foreach (var item in query)
{
Console.WriteLine(item);
}
}
catch (SqlException ex)
{
Console.WriteLine($"SQL例外発生: {ex.Message}");
}
}
}
SQL例外発生: ネットワーク関連またはインスタンス固有のエラーが発生しました。サーバーに接続できませんでした。
このように、LINQの実行環境によっては外部依存の例外も考慮する必要があります。
クエリ操作別リスクポイント
LINQの各種クエリ操作には、それぞれ特有の例外やリスクが存在します。
ここでは操作別に注意すべきポイントを具体的に解説します。
要素取得系
First
First()
は条件に合致する最初の要素を返しますが、該当する要素が存在しない場合にInvalidOperationException
をスローします。
空のシーケンスに対して呼び出すと例外が発生するため、事前にAny()
で存在チェックを行うか、FirstOrDefault()
の利用を検討してください。
var numbers = new List<int>();
try
{
var first = numbers.First(); // 例外発生
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
FirstOrDefault
FirstOrDefault()
は要素がない場合にデフォルト値(参照型ならnull
、値型ならdefault
)を返します。
例外は発生しませんが、戻り値がnull
や0
などのデフォルト値になる可能性があるため、呼び出し後のチェックが必要です。
var numbers = new List<int>();
var firstOrDefault = numbers.FirstOrDefault(); // 0が返る
Console.WriteLine(firstOrDefault);
Single
Single()
は条件に合致する要素が「ただ1つ」の場合にその要素を返します。
要素が0個または2個以上の場合はInvalidOperationException
が発生します。
ユニークな要素を取得したい場合に使いますが、要素数の保証がない場合は例外リスクが高いです。
var numbers = new List<int> { 1, 2 };
try
{
var single = numbers.Single(); // 例外発生(複数要素)
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
SingleOrDefault
SingleOrDefault()
は要素が0個の場合はデフォルト値を返し、1個の場合はその要素を返します。
2個以上の場合はInvalidOperationException
が発生します。
Single()
より安全ですが、複数要素の可能性がある場合は注意が必要です。
Last
Last()
は条件に合致する最後の要素を返します。
該当要素がない場合はInvalidOperationException
が発生します。
First()
と同様に、事前に存在チェックを行うかLastOrDefault()
を使うと安全です。
ElementAt
ElementAt(int index)
は指定したインデックスの要素を返します。
インデックスが範囲外の場合はArgumentOutOfRangeException
が発生します。
インデックスの妥当性を事前に確認するか、ElementAtOrDefault()
を使うと例外を回避できます。
var numbers = new List<int> { 10, 20 };
try
{
var element = numbers.ElementAt(5); // 例外発生
}
catch (ArgumentOutOfRangeException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
集計系
Max / Min / Average
これらの集計メソッドは空のシーケンスに対して呼び出すとInvalidOperationException
をスローします。
空のコレクションを扱う可能性がある場合は、DefaultIfEmpty()
でデフォルト値を設定するか、事前にAny()
で要素の有無を確認してください。
var numbers = new List<int>();
try
{
var max = numbers.Max(); // 例外発生
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
変換・型変換系
Select
Select()
は変換処理を行いますが、ラムダ式内でnull
参照や不正な操作を行うとNullReferenceException
やその他の例外が発生します。
変換処理内の安全性を確保することが重要です。
var list = new List<string?> { "abc", null, "def" };
try
{
var lengths = list.Select(s => s.Length).ToList(); // null参照例外
}
catch (NullReferenceException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
Cast
Cast<T>()
はシーケンス内の要素を指定した型にキャストします。
キャストできない要素があるとInvalidCastException
が発生します。
型が不明な場合はOfType<T>()
を使うと安全です。
var objects = new List<object> { 1, "string", 3 };
try
{
var ints = objects.Cast<int>().ToList(); // 例外発生
}
catch (InvalidCastException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
OfType
OfType<T>()
は指定した型にキャスト可能な要素だけを抽出します。
キャストできない要素は無視されるため、例外は発生しません。
安全に型フィルターをかけたい場合に有効です。
var objects = new List<object> { 1, "string", 3 };
var ints = objects.OfType<int>().ToList(); // 1, 3のみ抽出
フィルター系
Where
Where()
は条件に合致する要素を抽出します。
ラムダ式内でnull
参照や不正な操作を行うと例外が発生します。
特に、コレクションにnull
が含まれる場合は注意が必要です。
var list = new List<string?> { "abc", null, "def" };
try
{
var filtered = list.Where(s => s.Length > 2).ToList(); // null参照例外
}
catch (NullReferenceException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
Any / All
Any()
は条件に合致する要素が1つでもあればtrue
を返し、All()
はすべての要素が条件を満たすか判定します。
空のシーケンスに対してはAny()
はfalse
、All()
はtrue
を返します。
ラムダ式内の例外に注意してください。
結合・セット操作
Join / GroupJoin
Join()
やGroupJoin()
は2つのシーケンスをキーで結合します。
キーセレクターがnull
を返したり、比較子が不適切だと例外が発生することがあります。
また、結合対象のシーケンスがnull
の場合はArgumentNullException
が発生します。
var outer = new List<int> { 1, 2, 3 };
List<int>? inner = null;
try
{
var join = outer.Join(inner!, o => o, i => i, (o, i) => o + i).ToList();
}
catch (ArgumentNullException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
Union / Intersect / Except
これらのセット操作は、シーケンスの重複や差集合を計算します。
比較子が不正だったり、シーケンスがnull
の場合に例外が発生します。
特にnull
の扱いに注意が必要です。
var first = new List<int> { 1, 2, 3 };
List<int>? second = null;
try
{
var union = first.Union(second!).ToList();
}
catch (ArgumentNullException ex)
{
Console.WriteLine($"例外: {ex.Message}");
}
以上のように、LINQの各操作にはそれぞれ特有の例外リスクが存在します。
事前のnull
チェックや要素の存在確認、ラムダ式内の安全な処理を心がけることが重要です。
例外を防ぐ事前チェック
LINQを使う際に例外を未然に防ぐためには、事前のチェックや安全な操作を心がけることが重要です。
ここでは代表的な事前チェックの方法を具体的に解説します。
データソースの null 検査
LINQクエリの対象となるデータソースがnull
の場合、多くのLINQメソッドはArgumentNullException
をスローします。
これを防ぐために、クエリを実行する前に必ずデータソースがnull
でないことを確認しましょう。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int>? numbers = null;
if (numbers != null)
{
var result = numbers.Where(n => n > 0);
foreach (var num in result)
{
Console.WriteLine(num);
}
}
else
{
Console.WriteLine("データソースがnullです。処理を中止します。");
}
}
}
データソースがnullです。処理を中止します。
このようにnull
チェックを行うことで、例外の発生を防ぎ、安定した処理が可能になります。
要素存在確認に Any を使う
First()
やSingle()
などの要素取得系メソッドは、対象のシーケンスに要素が存在しないとInvalidOperationException
をスローします。
これを防ぐために、Any()
メソッドで要素の存在を事前に確認することが有効です。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int>();
if (numbers.Any())
{
var first = numbers.First();
Console.WriteLine(first);
}
else
{
Console.WriteLine("要素が存在しません。");
}
}
}
要素が存在しません。
Any()
はシーケンスに1つでも要素があればtrue
を返すため、効率的に存在チェックができます。
Count と Take で範囲制御
ElementAt()
やElementAtOrDefault()
を使う際、インデックスが範囲外だとArgumentOutOfRangeException
が発生します。
これを防ぐために、Count()
で要素数を確認し、Take()
で必要な範囲だけを取得する方法があります。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int> { 10, 20, 30 };
int index = 5;
if (index >= 0 && index < numbers.Count())
{
var element = numbers.ElementAt(index);
Console.WriteLine($"要素: {element}");
}
else
{
Console.WriteLine("インデックスが範囲外です。");
}
}
}
インデックスが範囲外です。
また、Take()
を使うと指定した数だけ要素を取得できるため、範囲外アクセスを回避しやすくなります。
OfType で型安全を高める
シーケンス内に異なる型のオブジェクトが混在している場合、Cast<T>()
を使うとInvalidCastException
が発生するリスクがあります。
OfType<T>()
を使うと、指定した型にキャスト可能な要素だけを抽出できるため、型安全に処理できます。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var objects = new List<object> { 1, "string", 2, null, 3 };
var ints = objects.OfType<int>();
foreach (var i in ints)
{
Console.WriteLine(i);
}
}
}
1
2
3
OfType<T>()
はキャストできない要素やnull
を自動的に除外するため、例外を防ぎつつ安全に型フィルターをかけられます。
TryParse による安全な数値変換
文字列を数値に変換する際、int.Parse()
やdouble.Parse()
は変換できない文字列があるとFormatException
をスローします。
TryParse()
を使うと変換の成否を判定でき、失敗しても例外が発生しません。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var strings = new List<string> { "100", "abc", "200", null, "300" };
var numbers = strings.Select(s =>
{
if (int.TryParse(s, out int result))
{
return (int?)result;
}
else
{
return null;
}
})
.Where(n => n.HasValue)
.Select(n => n.Value);
foreach (var num in numbers)
{
Console.WriteLine(num);
}
}
}
100
200
300
この方法で、変換失敗による例外を回避しつつ、正常に変換できた値だけを抽出できます。
null
や不正な文字列が混在するデータでも安全に処理可能です。
try-catch パターン別実装
LINQを使う際の例外処理は、状況に応じて適切なtry-catch
パターンを選択することが重要です。
ここでは基本的な単一例外の捕捉から、複数例外の個別処理、ログ記録、条件付きの例外捕捉まで、代表的なパターンを具体的に示します。
単一例外型を捕捉する基本形
最もシンプルな例外処理は、特定の例外型を捕捉して処理する方法です。
LINQでよく発生するInvalidOperationException
を捕捉する例を示します。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int>();
try
{
// 空のリストに対してFirst()を呼び出すと例外が発生
int first = numbers.First();
Console.WriteLine(first);
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外捕捉: {ex.Message}");
}
}
}
例外捕捉: シーケンスに要素が含まれていません。
このパターンは、特定の例外に対して明確な対応を行いたい場合に有効です。
複数例外型を個別処理する応用形
複数の例外が考えられる場合は、catch
ブロックを複数用意して個別に処理します。
例えば、ArgumentNullException
とInvalidOperationException
を分けて処理する例です。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int>? numbers = null;
try
{
// numbersがnullなのでArgumentNullExceptionが発生
var first = numbers!.First();
Console.WriteLine(first);
}
catch (ArgumentNullException ex)
{
Console.WriteLine($"ArgumentNullException捕捉: {ex.Message}");
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"InvalidOperationException捕捉: {ex.Message}");
}
}
}
ArgumentNullException捕捉: 値は null であってはなりません。 (パラメーター名: source)
この方法で例外ごとに異なる対応が可能となり、より詳細なエラーハンドリングが実現できます。
最終 catch でのログ記録
すべての例外を捕捉するために、最後に一般的なcatch (Exception ex)
を置き、ログ記録や通知処理を行うパターンです。
特定例外の処理後に、想定外の例外も漏らさず対応できます。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<int>? numbers = null;
try
{
var first = numbers!.First();
Console.WriteLine(first);
}
catch (ArgumentNullException ex)
{
Console.WriteLine($"ArgumentNullException捕捉: {ex.Message}");
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"InvalidOperationException捕捉: {ex.Message}");
}
catch (Exception ex)
{
// 予期しない例外のログ記録
Console.WriteLine($"予期しない例外: {ex.GetType().Name} - {ex.Message}");
}
}
}
ArgumentNullException捕捉: 値は null であってはなりません。 (パラメーター名: source)
このパターンは堅牢な例外処理を実装する際に推奨されます。
catch フィルターによる条件分岐
C#のcatch
フィルターを使うと、例外の内容に応じて条件を指定し、特定の条件下でのみ例外を捕捉できます。
例えば、InvalidOperationException
のメッセージに特定のキーワードが含まれる場合だけ処理する例です。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int>();
try
{
int first = numbers.First();
Console.WriteLine(first);
}
catch (InvalidOperationException ex) when (ex.Message.Contains("要素"))
{
Console.WriteLine($"条件付き捕捉: {ex.Message}");
}
catch (Exception ex)
{
Console.WriteLine($"その他の例外: {ex.Message}");
}
}
}
条件付き捕捉: シーケンスに要素が含まれていません。
catch
フィルターは複雑な例外判定を簡潔に記述でき、例外処理の柔軟性を高めます。
メソッドチェーン内での例外処理戦略
LINQのメソッドチェーンは非常に強力ですが、複雑な処理を一連のメソッドでつなぐと、例外発生時の原因特定や処理が難しくなることがあります。
ここでは、メソッドチェーン内での例外処理を効率的に行うための戦略を紹介します。
クエリ分割でデバッグ容易化
長いメソッドチェーンを一気に書くと、どの段階で例外が発生したのか把握しづらくなります。
そこで、クエリを複数の段階に分割して変数に代入し、それぞれの段階で結果を確認しながら進める方法が有効です。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var data = new List<string?> { "10", "20", null, "abc", "30" };
// 1. null除外
var nonNullData = data.Where(s => s != null);
Console.WriteLine("null除外後:");
foreach (var item in nonNullData)
{
Console.WriteLine(item);
}
// 2. 数値変換可能なものだけ抽出
var numericData = nonNullData.Where(s => int.TryParse(s, out _));
Console.WriteLine("数値変換可能なもの:");
foreach (var item in numericData)
{
Console.WriteLine(item);
}
// 3. intに変換
var numbers = numericData.Select(s => int.Parse(s!));
Console.WriteLine("変換後の数値:");
foreach (var num in numbers)
{
Console.WriteLine(num);
}
}
}
null除外後:
10
20
abc
30
数値変換可能なもの:
10
20
30
変換後の数値:
10
20
30
このように段階ごとに処理を分割すると、どの段階で問題が起きているかが明確になり、デバッグや例外処理がしやすくなります。
拡張メソッド WithDefault の自作
メソッドチェーン内で例外が発生しやすい要素取得系メソッド(First()
, Single()
など)に対して、例外を防ぎつつデフォルト値を返す拡張メソッドを自作する方法があります。
これにより、例外処理をメソッドチェーンの中に組み込み、コードの見通しを良くできます。
using System;
using System.Collections.Generic;
using System.Linq;
public static class LinqExtensions
{
public static T WithDefault<T>(this IEnumerable<T> source, Func<IEnumerable<T>, T> selector, T defaultValue)
{
try
{
return selector(source);
}
catch (InvalidOperationException)
{
return defaultValue;
}
}
}
class Program
{
static void Main()
{
var numbers = new List<int>();
// First()で例外が発生する可能性があるが、WithDefaultでデフォルト値を返す
int first = numbers.WithDefault(seq => seq.First(), -1);
Console.WriteLine(first);
}
}
-1
このWithDefault
拡張メソッドは、任意のLINQ操作をラップし、InvalidOperationException
が発生した場合に指定したデフォルト値を返します。
これにより、例外処理を分散させずにメソッドチェーン内で安全に値を取得できます。
Option 型や Nullable の活用
C#ではNullable<T>
型や、外部ライブラリのOption<T>
型を活用して、値の有無を明示的に扱うことができます。
これにより、例外を使わずに安全に値の存在を表現し、例外処理の負担を減らせます。
Nullable型の例
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var numbers = new List<int>();
int? firstOrNull = numbers.Cast<int?>().FirstOrDefault();
if (firstOrNull.HasValue)
{
Console.WriteLine($"最初の要素: {firstOrNull.Value}");
}
else
{
Console.WriteLine("要素が存在しません。");
}
}
}
要素が存在しません。
Option型の例(外部ライブラリ使用想定)
using System;
using System.Collections.Generic;
using System.Linq;
using LanguageExt; // 例: LanguageExtライブラリのOption<T>
class Program
{
static void Main()
{
var numbers = new List<int>();
Option<int> firstOption = numbers.Any() ? Prelude.Some(numbers.First()) : Prelude.None;
firstOption.Match(
Some: val => Console.WriteLine($"最初の要素: {val}"),
None: () => Console.WriteLine("要素が存在しません。")
);
}
}
Option<T>
は値が存在するかどうかを型で表現し、Match
メソッドで安全に処理を分岐できます。
例外を使わずに値の有無を扱うことで、コードの安全性と可読性が向上します。
これらの戦略を組み合わせることで、メソッドチェーン内での例外発生を抑えつつ、可読性と保守性の高いLINQコードを実現できます。
PLINQ での例外管理
Parallel LINQ(PLINQ)は複数スレッドで並列処理を行うため、例外処理の方法が通常のLINQとは異なります。
ここでは、PLINQで発生するAggregateException
の扱い方や、CancellationToken
を使った処理中断、例外の再スローに関する判断基準について詳しく説明します。
AggregateException の展開と解析
PLINQでは、複数のスレッドで同時に例外が発生する可能性があるため、例外はAggregateException
としてまとめてスローされます。
AggregateException
は内部に複数の例外を持つため、これを展開して個別に処理する必要があります。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
class Program
{
static void Main()
{
var numbers = Enumerable.Range(1, 10);
try
{
var query = numbers.AsParallel().Select(n =>
{
if (n % 3 == 0)
throw new InvalidOperationException($"無効な操作: {n}");
return n;
});
foreach (var num in query)
{
Console.WriteLine(num);
}
}
catch (AggregateException ex)
{
Console.WriteLine("AggregateExceptionを捕捉しました。内部例外を展開します。");
foreach (var innerEx in ex.InnerExceptions)
{
Console.WriteLine($"例外タイプ: {innerEx.GetType().Name}, メッセージ: {innerEx.Message}");
}
}
}
}
1
2
4
5
7
8
10
AggregateExceptionを捕捉しました。内部例外を展開します。
例外タイプ: InvalidOperationException, メッセージ: 無効な操作: 3
例外タイプ: InvalidOperationException, メッセージ: 無効な操作: 6
例外タイプ: InvalidOperationException, メッセージ: 無効な操作: 9
このように、AggregateException
のInnerExceptions
プロパティを使って個々の例外を取り出し、適切にログ記録や復旧処理を行います。
CancellationToken と組み合わせた中断
PLINQの並列処理はCancellationToken
と組み合わせることで、外部から処理の中断を制御できます。
これにより、例外発生時やユーザー操作によるキャンセル要求に応じて安全に処理を停止できます。
using System;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
class Program
{
static void Main()
{
var cts = new CancellationTokenSource();
var token = cts.Token;
var numbers = Enumerable.Range(1, 100);
Task.Run(() =>
{
// 2秒後にキャンセル要求を送る
Thread.Sleep(2000);
cts.Cancel();
Console.WriteLine("キャンセル要求を送信しました。");
});
try
{
var query = numbers.AsParallel()
.WithCancellation(token)
.Select(n =>
{
// キャンセルが要求されたら例外をスロー
token.ThrowIfCancellationRequested();
// 重い処理のシミュレーション
Thread.Sleep(500);
return n;
});
foreach (var num in query)
{
Console.WriteLine(num);
}
}
catch (OperationCanceledException)
{
Console.WriteLine("処理はキャンセルされました。");
}
catch (AggregateException ex)
{
Console.WriteLine("AggregateExceptionを捕捉しました。");
foreach (var innerEx in ex.InnerExceptions)
{
Console.WriteLine($"例外: {innerEx.Message}");
}
}
}
}
1
2
キャンセル要求を送信しました。
処理はキャンセルされました。
WithCancellation
メソッドでCancellationToken
を渡し、ThrowIfCancellationRequested
でキャンセルを検知して例外をスローします。
これにより、並列処理を安全に中断できます。
例外再スローの可否と判断基準
PLINQで例外が発生した場合、例外をキャッチして処理を行った後に再スローするかどうかは、アプリケーションの要件や例外の性質によって判断します。
- 再スローすべき場合
- 例外が致命的で処理継続が不可能な場合
- 上位層での一括例外処理やログ収集が必要な場合
- トランザクションのロールバックやリソース解放を確実に行う必要がある場合
- 再スローしない場合
- 例外が一時的でリトライ可能な場合
- 例外を局所的に処理し、正常な処理を継続できる場合
- ユーザーにエラーメッセージを表示して処理を終了させる場合
再スローする際は、throw;
を使って元のスタックトレースを保持することが推奨されます。
try
{
// PLINQ処理
}
catch (AggregateException ex)
{
foreach (var inner in ex.InnerExceptions)
{
// ログ記録や特定例外の処理
}
throw; // 元の例外を再スロー
}
このように、例外の重要度や処理方針に応じて再スローの有無を決定し、適切な例外管理を行うことが安定した並列処理の鍵となります。
非同期 LINQ 風ライブラリでの注意点
非同期処理が一般化する中で、C#ではIAsyncEnumerable<T>
を使った非同期LINQ風の操作が増えています。
非同期ストリームを扱う際の例外処理には特有の注意点があり、async/await
との組み合わせや例外捕捉のタイミングを正しく理解することが重要です。
IAsyncEnumerable との組み合わせ
IAsyncEnumerable<T>
は非同期に要素を逐次取得できるインターフェースで、await foreach
構文で列挙します。
LINQ風の非同期拡張メソッド(WhereAwait
, SelectAwait
など)を使うことで、非同期ストリームに対してクエリを組み立てられます。
ただし、IAsyncEnumerable<T>
の列挙中に例外が発生すると、await foreach
の実行時にスローされます。
つまり、クエリの定義時点では例外は発生せず、列挙(イテレーション)時に例外が伝播します。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
class Program
{
static async IAsyncEnumerable<int> GetNumbersAsync()
{
yield return 1;
yield return 2;
throw new InvalidOperationException("非同期ストリームで例外発生");
yield return 3;
}
static async Task Main()
{
var numbers = GetNumbersAsync();
try
{
await foreach (var num in numbers)
{
Console.WriteLine(num);
}
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"例外捕捉: {ex.Message}");
}
}
}
1
2
例外捕捉: 非同期ストリームで例外発生
このように、非同期ストリームの例外はawait foreach
の中で捕捉する必要があります。
クエリの構築時には例外は発生しないため、実行時の例外処理を忘れないようにしましょう。
async / await と try-catch の配置
非同期メソッド内でawait
を使う場合、例外はawait
の呼び出し元に伝播します。
したがって、try-catch
ブロックはawait
を含む非同期操作の周囲に配置する必要があります。
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
class Program
{
static async Task<int> DivideAsync(int a, int b)
{
await Task.Delay(100);
return a / b; // 0除算の可能性あり
}
static async Task Main()
{
try
{
int result = await DivideAsync(10, 0);
Console.WriteLine(result);
}
catch (DivideByZeroException ex)
{
Console.WriteLine($"例外捕捉: {ex.Message}");
}
}
}
例外捕捉: Attempted to divide by zero.
try-catch
をawait
の外側に置くことで、非同期処理中に発生した例外を正しく捕捉できます。
逆に、try-catch
を非同期メソッドの内部に置いても、呼び出し元で例外を捕捉することが可能ですが、例外の伝播経路を明確にするために呼び出し元での捕捉が一般的です。
また、複数の非同期操作を連続して行う場合は、それぞれのawait
に対して個別にtry-catch
を設けるか、まとめて囲むかを設計に応じて選択します。
try
{
var data = await GetDataAsync();
var processed = await ProcessDataAsync(data);
}
catch (Exception ex)
{
Console.WriteLine($"例外捕捉: {ex.Message}");
}
このように、非同期LINQ風処理ではawait
のタイミングで例外が発生するため、try-catch
の配置を適切に行い、例外の漏れを防ぐことが重要です。
ロギングとモニタリング
LINQを含むアプリケーションで例外が発生した際、適切なロギングとモニタリングを行うことは問題の早期発見と迅速な対応に不可欠です。
ここでは、C#環境でよく使われるロギングフレームワークやモニタリング手法について具体的に解説します。
Serilog での例外パイプライン
Serilogは構造化ログを簡単に実装できる人気のロギングライブラリです。
例外情報を詳細にログに含めることができ、LINQ処理中に発生した例外も効率的に記録できます。
using System;
using System.Collections.Generic;
using System.Linq;
using Serilog;
class Program
{
static void Main()
{
// Serilogの設定(コンソール出力)
Log.Logger = new LoggerConfiguration()
.WriteTo.Console()
.CreateLogger();
var numbers = new List<int>();
try
{
// 空リストに対してFirst()を呼び出し例外発生
int first = numbers.First();
}
catch (Exception ex)
{
// 例外をSerilogで詳細にログ出力
Log.Error(ex, "LINQ処理中に例外が発生しました");
}
finally
{
Log.CloseAndFlush();
}
}
}
[Error] LINQ処理中に例外が発生しました
System.InvalidOperationException: シーケンスに要素が含まれていません。
at System.Linq.Enumerable.First[TSource](IEnumerable`1 source)
at Program.Main()
Serilogは例外のスタックトレースやメッセージを構造化データとして扱うため、後から検索やフィルタリングが容易です。
さらに、ファイルやリモートサーバーへの出力も簡単に設定でき、運用環境でのトラブルシューティングに役立ちます。
イベントソースと ETW 発火
Windows環境では、EventSource
クラスを使ってイベントトレース(ETW: Event Tracing for Windows)を発火させることができます。
これにより、システムレベルでの詳細なトレース収集が可能となり、パフォーマンス解析や例外発生状況の監視に活用されます。
using System;
using System.Diagnostics.Tracing;
using System.Linq;
[EventSource(Name = "SampleApp-LinqEvents")]
class LinqEventSource : EventSource
{
public static LinqEventSource Log = new LinqEventSource();
[Event(1, Level = EventLevel.Error, Message = "LINQ例外: {0}")]
public void LinqException(string message)
{
if (IsEnabled()) WriteEvent(1, message);
}
}
class Program
{
static void Main()
{
var numbers = new int[0];
try
{
var first = numbers.First();
}
catch (Exception ex)
{
LinqEventSource.Log.LinqException(ex.Message);
}
}
}
ETWはWindowsのパフォーマンスモニタや専用ツール(PerfViewなど)でリアルタイムにイベントを収集・分析できるため、大規模システムの監視に適しています。
Application Insights でのトレース収集
AzureのApplication Insightsはクラウドベースの監視サービスで、アプリケーションの例外やパフォーマンスデータを収集・可視化します。
C#アプリケーションにSDKを組み込むことで、LINQ処理中の例外も自動的にトレースされます。
using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.Extensibility;
class Program
{
static void Main()
{
var telemetryConfig = TelemetryConfiguration.CreateDefault();
telemetryConfig.InstrumentationKey = "YOUR_INSTRUMENTATION_KEY";
var telemetryClient = new TelemetryClient(telemetryConfig);
var numbers = new List<int>();
try
{
int first = numbers.First();
}
catch (Exception ex)
{
telemetryClient.TrackException(ex);
telemetryClient.Flush();
Console.WriteLine("例外をApplication Insightsに送信しました。");
}
}
}
Application Insightsは例外の詳細情報だけでなく、依存関係やリクエストのトレースも収集できるため、問題の根本原因分析に非常に有効です。
リアルタイムのアラート設定も可能で、運用監視の自動化に役立ちます。
これらのロギング・モニタリング手法を適切に組み合わせることで、LINQを含むアプリケーションの例外発生状況を正確に把握し、迅速な対応が可能になります。
パフォーマンスと例外処理
例外処理はプログラムの堅牢性を高める重要な機能ですが、過剰に使うとパフォーマンスに悪影響を及ぼすことがあります。
LINQを使った処理においても例外処理の設計は慎重に行う必要があります。
ここでは、過剰なtry-catch
の影響や、代表的な要素取得方法のパフォーマンス比較、例外発生時のJIT(Just-In-Time)コンパイルのペナルティについて解説します。
過剰な try-catch が及ぼす影響
try-catch
ブロック自体は、例外が発生しなければほとんどパフォーマンスに影響を与えません。
しかし、過剰に多用したり、頻繁に例外をスロー・キャッチするコードはパフォーマンス低下の原因となります。
- 例外発生時のコストが高い
例外がスローされると、スタックの巻き戻しや例外オブジェクトの生成など多くの処理が発生し、通常の条件分岐よりもはるかに重い処理となります。
- try-catchの多用によるコード肥大化
多数のtry-catch
を使うと、JITコンパイラの最適化が制限され、メソッドのインライン化や最適化が妨げられることがあります。
- 例外を制御フローに使うのは避けるべき
例外はあくまで「例外的な状況」を扱うためのものであり、通常の条件分岐やチェックで代替可能な場合は例外処理を使わないほうが良いです。
LINQの例では、First()
で要素がない場合に例外が発生しますが、事前にAny()
で存在チェックを行うことで例外発生を防ぎ、パフォーマンスを向上させることができます。
FirstOrDefault と Any + First の比較
要素の存在チェックと取得を行う場合、FirstOrDefault()
を使う方法と、Any()
で存在確認してからFirst()
を呼ぶ方法があります。
これらのパフォーマンス差を理解して使い分けることが重要です。
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
class Program
{
static void Main()
{
var numbers = Enumerable.Range(1, 1000000).ToList();
var sw = new Stopwatch();
// FirstOrDefault の計測
sw.Start();
int result1 = numbers.Where(n => n > 1000000).FirstOrDefault();
sw.Stop();
Console.WriteLine($"FirstOrDefault: {sw.ElapsedMilliseconds} ms");
sw.Reset();
// Any + First の計測
sw.Start();
int result2 = numbers.Any(n => n > 1000000) ? numbers.First(n => n > 1000000) : 0;
sw.Stop();
Console.WriteLine($"Any + First: {sw.ElapsedMilliseconds} ms");
}
}
FirstOrDefault: 10 ms
Any + First: 20 ms
FirstOrDefault()
は条件に合う最初の要素を返し、存在しなければデフォルト値を返すため、1回の列挙で済みますAny() + First()
は2回列挙が発生するため、パフォーマンスは劣ります
したがって、単純に要素を取得したい場合はFirstOrDefault()
を使うほうが効率的です。
ただし、First()
で例外を発生させたい場合や、存在チェックと取得を明確に分けたい場合はAny()
を使う選択肢もあります。
例外発生時の JIT ペナルティ
例外がスローされると、JITコンパイラは例外処理用のコードを生成し、例外発生時のスタックトレースの収集や例外オブジェクトの生成など多くの処理を行います。
このため、例外が頻繁に発生するとJITのパフォーマンスに大きなペナルティがかかります。
- 例外発生はパフォーマンスのボトルネック
例外が発生すると、通常のコードパスよりも数十倍から数百倍の時間がかかることがあります。
- JITの最適化が制限される
try-catch
ブロックが多いと、JITはメソッドのインライン化やループの最適化を控える傾向があり、全体のパフォーマンスが低下します。
- 例外を使った制御フローは避ける
例外はあくまで異常系の処理に限定し、通常の条件分岐で処理を分けることが推奨されます。
まとめると、LINQで例外が発生しやすいメソッド(First()
など)を使う場合は、事前に要素の存在をチェックするか、FirstOrDefault()
を使って例外発生を抑制することがパフォーマンス向上につながります。
また、try-catch
は必要最小限に留め、例外を多用しない設計を心がけることが重要です。
テストコードでの例外確認
LINQを使った処理で例外が正しく発生するかどうかをテストコードで検証することは、堅牢なアプリケーション開発に欠かせません。
ここでは、代表的なテストフレームワークでの例外確認方法と、データドリブンテストによる境界値検証の実践例を紹介します。
xUnit の Assert.Throws
xUnitでは、Assert.Throws<TException>
メソッドを使って、特定の例外が発生することを検証します。
例外が発生しなかった場合や異なる例外が発生した場合はテストが失敗します。
using System;
using System.Collections.Generic;
using System.Linq;
using Xunit;
public class LinqExceptionTests
{
[Fact]
public void First_EmptySequence_ThrowsInvalidOperationException()
{
var numbers = new List<int>();
var ex = Assert.Throws<InvalidOperationException>(() =>
{
// 空のリストに対してFirst()を呼び出すと例外が発生
var first = numbers.First();
});
Assert.Equal("シーケンスに要素が含まれていません。", ex.Message);
}
}
このテストでは、空のシーケンスに対してFirst()
を呼び出した際にInvalidOperationException
が発生することを検証しています。
例外メッセージもAssert.Equal
で確認可能です。
MSTest の ExpectedException 属性
MSTestでは、テストメソッドに[ExpectedException(typeof(TException))]
属性を付与することで、指定した例外が発生することを期待します。
例外が発生しなければテストは失敗します。
using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.VisualStudio.TestTools.UnitTesting;
[TestClass]
public class LinqExceptionTests
{
[TestMethod]
[ExpectedException(typeof(InvalidOperationException))]
public void First_EmptySequence_ThrowsInvalidOperationException()
{
var numbers = new List<int>();
// 例外が発生しなければテスト失敗
var first = numbers.First();
}
}
ExpectedException
属性は簡潔に例外発生を検証できますが、例外メッセージの検証や例外発生箇所の特定が難しいため、詳細な検証が必要な場合はtry-catch
を使った検証も検討してください。
データドリブンテストでの境界値検証
例外発生の境界条件を複数パターンで検証するには、データドリブンテスト(パラメータ化テスト)が有効です。
xUnitの[Theory]
と[InlineData]
を使った例を示します。
using System;
using System.Collections.Generic;
using System.Linq;
using Xunit;
public class LinqBoundaryTests
{
[Theory]
[InlineData(new int[] { })]
[InlineData(new int[] { 1, 2 })]
public void Single_Sequence_ThrowsInvalidOperationException(int[] input)
{
var numbers = input.ToList();
if (numbers.Count() != 1)
{
var ex = Assert.Throws<InvalidOperationException>(() =>
{
var single = numbers.Single();
});
Assert.Contains("シーケンスに複数の要素が含まれています。", ex.Message);
}
else
{
// 要素が1つの場合は例外が発生しないことを確認
var single = numbers.Single();
Assert.Equal(1, single);
}
}
}
このテストでは、空配列や複数要素の配列でSingle()
が例外をスローすることを検証し、要素が1つの場合は正常に取得できることも確認しています。
複数の境界値を効率的にテストできるため、例外処理の堅牢性を高めるのに役立ちます。
これらのテスト手法を活用することで、LINQ処理における例外発生の有無や内容を正確に検証でき、品質の高いコードを維持できます。
実務で使えるサンプルパターン集
実務でLINQを活用する際に遭遇しやすいシナリオに対して、例外を防ぎつつ安全に処理を行うための具体的なサンプルパターンを紹介します。
API レスポンスの null 安全変換
APIから取得したレスポンスデータにはnull
や欠損値が含まれることが多く、LINQでの変換時にNullReferenceException
が発生しやすいです。
以下の例では、null
チェックを組み込みつつ安全に変換を行う方法を示します。
using System;
using System.Collections.Generic;
using System.Linq;
class ApiResponse
{
public string? Name { get; set; }
public int? Age { get; set; }
}
class Program
{
static void Main()
{
var responses = new List<ApiResponse?>
{
new ApiResponse { Name = "Alice", Age = 30 },
null,
new ApiResponse { Name = null, Age = 25 },
new ApiResponse { Name = "Bob", Age = null }
};
var safeUsers = responses
.Where(r => r != null) // null除外
.Select(r => new
{
Name = r!.Name ?? "不明", // null合体演算子でデフォルト値設定
Age = r.Age ?? 0
});
foreach (var user in safeUsers)
{
Console.WriteLine($"名前: {user.Name}, 年齢: {user.Age}");
}
}
}
名前: Alice, 年齢: 30
名前: 不明, 年齢: 25
名前: Bob, 年齢: 0
このパターンでは、null
のレスポンスやプロパティを安全に扱い、例外を防止しつつデフォルト値を設定しています。
CSV 読み込み時のデータ検証
CSVファイルの読み込みでは、データの欠損や形式不正が原因で例外が発生しやすいです。
LINQで読み込んだデータを検証し、不正な行を除外するパターンを示します。
using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Linq;
class CsvRecord
{
public string Name { get; set; } = "";
public int Age { get; set; }
}
class Program
{
static void Main()
{
var lines = new List<string>
{
"Alice,30",
"Bob,abc", // 年齢不正
"Charlie,25",
",40", // 名前欠損
"David,35"
};
var records = lines
.Select(line => line.Split(','))
.Where(fields => fields.Length == 2)
.Select(fields =>
{
bool ageParsed = int.TryParse(fields[1], NumberStyles.Integer, CultureInfo.InvariantCulture, out int age);
return new
{
Name = fields[0],
Age = ageParsed ? age : (int?)null
};
})
.Where(r => !string.IsNullOrWhiteSpace(r.Name) && r.Age.HasValue)
.Select(r => new CsvRecord { Name = r.Name, Age = r.Age!.Value });
foreach (var record in records)
{
Console.WriteLine($"名前: {record.Name}, 年齢: {record.Age}");
}
}
}
名前: Alice, 年齢: 30
名前: Charlie, 年齢: 25
名前: David, 年齢: 35
この例では、int.TryParse
で年齢の数値変換を安全に行い、名前の空白チェックも行うことで不正データを除外しています。
これにより、例外を防ぎつつ正しいデータのみを処理できます。
データベースクエリのタイムアウト対策
LINQ to EntitiesやLINQ to SQLで長時間かかるクエリがある場合、タイムアウト例外が発生することがあります。
これを防ぐために、クエリのタイムアウト設定やキャンセルトークンを活用するパターンを示します。
using System;
using System.Data.Entity; // Entity Framework 6の場合
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var context = new SampleDbContext();
// タイムアウトを設定(秒)
context.Database.CommandTimeout = 10;
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10));
try
{
var query = context.Users.Where(u => u.IsActive);
// キャンセルトークンを渡して非同期実行
var users = await query.ToListAsync(cts.Token);
foreach (var user in users)
{
Console.WriteLine(user.Name);
}
}
catch (OperationCanceledException)
{
Console.WriteLine("クエリがキャンセルされました(タイムアウトなど)。");
}
catch (Exception ex)
{
Console.WriteLine($"例外発生: {ex.Message}");
}
}
}
// DbContextとUserエンティティは省略
このパターンでは、CommandTimeout
でSQLコマンドのタイムアウトを設定し、CancellationTokenSource
でキャンセルを制御しています。
タイムアウトやキャンセルが発生した場合はOperationCanceledException
がスローされるため、適切にキャッチして処理を行います。
これらのサンプルパターンを活用することで、実務でよくある例外発生リスクを抑え、安全かつ効率的にLINQを利用したデータ処理を実現できます。
参考コード断片の共通エラー
LINQを使ったコードを書く際に、よく見られる落とし穴や誤りがあります。
特にクロージャ(クローズドオーバー変数)に関する問題や、using
ブロック内での遅延実行が原因で発生する例外は初心者から中級者まで注意が必要です。
ここでは代表的な2つの問題を具体例とともに解説します。
クローズドオーバー変数と例外
クロージャとは、ラムダ式や匿名メソッドが外側の変数を参照する仕組みのことです。
LINQのクエリ内でループ変数などをクロージャとして捕捉すると、意図しない動作や例外が発生することがあります。
問題の例
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
var actions = new List<Action>();
for (int i = 0; i < 3; i++)
{
// iをクロージャとして捕捉している
actions.Add(() => Console.WriteLine(i));
}
foreach (var action in actions)
{
action();
}
}
}
3
3
3
この例では、ループ変数i
をクロージャとして捕捉しているため、ループ終了後のi
の値(3)がすべてのラムダ式で参照されてしまい、期待した0, 1, 2
ではなく3
が3回出力されます。
LINQでの影響
LINQのクエリ内で同様にループ変数を使うと、遅延実行時に変数の値が変わっているため、意図しない結果や例外が発生することがあります。
解決策
ループ変数をローカル変数にコピーしてからクロージャに渡すことで問題を回避できます。
for (int i = 0; i < 3; i++)
{
int local = i; // コピー
actions.Add(() => Console.WriteLine(local));
}
これにより、各ラムダ式はそれぞれ異なるlocal
変数を参照し、期待通り0, 1, 2
が出力されます。
using 内での遅延実行が招く問題
LINQは遅延実行の特性を持つため、using
ブロック内でデータソースを生成し、そのままクエリを返すと、using
のスコープを抜けた後にクエリを実行した際に例外が発生します。
これは、using
で解放されたリソースにアクセスしようとするためです。
問題の例
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
class Program
{
static IEnumerable<string> ReadLines(string path)
{
using var reader = new StreamReader(path);
// 遅延実行のため、ここではまだ読み込みは行われない
return reader.ReadLine().Yield();
}
}
static class Extensions
{
public static IEnumerable<T> Yield<T>(this T item)
{
yield return item;
}
}
class Test
{
static void Main()
{
var lines = Program.ReadLines("sample.txt");
// usingブロック外で列挙しようとすると例外が発生する可能性がある
foreach (var line in lines)
{
Console.WriteLine(line);
}
}
}
このコードでは、StreamReader
がusing
でスコープを抜けると破棄されるため、ReadLines
の戻り値であるIEnumerable<string>
を列挙する際にObjectDisposedException
が発生する恐れがあります。
解決策
- 即時実行でデータを取得する
using
内でToList()
やToArray()
を使い、遅延実行を防いでデータをメモリに読み込んでから返します。
static IEnumerable<string> ReadLines(string path)
{
using var reader = new StreamReader(path);
var lines = new List<string>();
string? line;
while ((line = reader.ReadLine()) != null)
{
lines.Add(line);
}
return lines;
}
yield return
を使わずに即時実行を保証する
遅延実行を避けることで、リソースの解放後にアクセスする問題を防げます。
これらの共通エラーはLINQの遅延実行やクロージャの仕組みを正しく理解していないと起こりやすいため、注意深くコードを書くことが重要です。
適切な変数スコープの管理とリソースのライフサイクル制御を心がけましょう。
まとめ
本記事では、C#のLINQで発生しやすい例外の原因と安全なエラーハンドリングの実践テクニックを解説しました。
遅延実行の特性や代表的な例外クラスの特徴、事前チェックや適切なtry-catch
パターンの使い分け、メソッドチェーン内での例外処理戦略などを具体例とともに紹介しています。
さらに、PLINQや非同期LINQ、ロギング・モニタリング、パフォーマンス面の注意点も網羅。
実務で役立つサンプルやよくあるコードの落とし穴も理解でき、堅牢で効率的なLINQ活用に役立つ内容です。