[C#] 例外：AggregateExceptionの原因と対処法を解説

2025-04-15更新日: 2025-04-15

AggregateExceptionは、複数の例外が同時に発生した場合に、それらをまとめて1つの例外としてスローするために使用されます。

主に非同期処理や並列処理(例：TaskやParallelクラス)で発生します。

原因としては、複数のタスクが並行して実行され、その中で1つ以上のタスクが例外をスローした場合です。

対処法としては、AggregateExceptionのInnerExceptionsプロパティを使用して、個々の例外を確認し、適切に処理することが推奨されます。

目次から探す

AggregateExceptionとは
AggregateExceptionが発生する原因
AggregateExceptionの構造
AggregateExceptionの対処法
実際のコード例
応用例
まとめ

AggregateExceptionとは

AggregateExceptionは、C#における例外処理の一種で、複数の例外をまとめて管理するためのクラスです。

主に非同期プログラミングや並列処理において、複数のタスクが同時に実行される際に、いくつかのタスクが失敗した場合に発生します。

このクラスは、発生したすべての例外を一つのオブジェクトにまとめることで、例外処理を簡素化します。

AggregateExceptionは、InnerExceptionsプロパティを通じて、発生した各例外の詳細情報にアクセスできるため、個別の例外を確認し、適切な対処を行うことが可能です。

これにより、開発者は複数のエラーを一度に処理し、アプリケーションの安定性を向上させることができます。

特に、非同期メソッドやタスクを使用する際には、AggregateExceptionの理解が重要です。

AggregateExceptionが発生する原因

非同期処理における例外

非同期処理では、複数のタスクが同時に実行されるため、各タスクが独立して例外を発生させる可能性があります。

これにより、非同期メソッドが完了する際に、複数の例外が同時に発生し、AggregateExceptionがスローされます。

非同期メソッドを使用する際は、各タスクの例外を適切に処理することが重要です。

並列処理における例外

並列処理では、Parallelクラスを使用して複数の処理を同時に実行します。

この際、各スレッドが独自に例外を発生させることがあり、これらの例外がまとめてAggregateExceptionとしてスローされます。

並列処理を行う場合は、例外管理をしっかりと行う必要があります。

複数のタスクが失敗した場合

複数のタスクが同時に実行されている場合、いくつかのタスクが失敗することがあります。

これにより、各タスクから発生した例外がAggregateExceptionにまとめられ、呼び出し元に返されます。

このような状況では、どのタスクが失敗したのかを特定し、適切な対処を行うことが求められます。

タスクのキャンセル時に発生する例外

タスクがキャンセルされた場合、OperationCanceledExceptionがスローされることがあります。

この例外もAggregateExceptionに含まれるため、複数のタスクがキャンセルされた場合には、AggregateExceptionを通じて一括で処理することができます。

タスクのキャンセルを適切に管理することで、アプリケーションの安定性を保つことができます。

AggregateExceptionの構造

InnerExceptionsプロパティとは

InnerExceptionsプロパティは、AggregateExceptionクラスの重要な要素であり、発生したすべての例外を格納するコレクションです。

このプロパティを使用することで、個々の例外にアクセスし、それぞれの詳細情報を確認することができます。

InnerExceptionsは、IEnumerable<Exception>型であり、複数の例外をリスト形式で取得できます。

これにより、開発者はどのタスクが失敗したのかを特定し、適切なエラーハンドリングを行うことが可能です。

Flattenメソッドの役割

Flattenメソッドは、AggregateException内のすべての例外を一つのリストに平坦化するためのメソッドです。

通常、AggregateExceptionは、他のAggregateExceptionを内包することがありますが、Flattenメソッドを使用することで、すべての例外を単一のリストにまとめることができます。

これにより、例外の階層構造を気にせず、すべての例外を一度に処理することが容易になります。

Handleメソッドの使い方

Handleメソッドは、AggregateException内の例外をフィルタリングし、特定の条件に基づいて処理するためのメソッドです。

このメソッドを使用することで、特定の種類の例外のみを処理し、他の例外は再スローすることができます。

Handleメソッドには、例外を受け取るデリゲートを渡すことができ、条件に合致する例外に対してカスタム処理を行うことが可能です。

これにより、特定のエラーに対して柔軟な対応ができるようになります。

AggregateExceptionの対処法

try-catchでの基本的な処理方法

AggregateExceptionを処理する最も基本的な方法は、try-catchブロックを使用することです。

非同期メソッドや並列処理の中でAggregateExceptionが発生した場合、catchブロックでこの例外を捕捉し、適切なエラーメッセージを表示することができます。

以下はその基本的な例です。

try
{
    // 非同期処理や並列処理を実行
}
catch (AggregateException ex)
{
    Console.WriteLine("例外が発生しました。");
}

InnerExceptionsを使った個別例外の処理

InnerExceptionsプロパティを使用することで、AggregateException内の各例外にアクセスし、個別に処理することができます。

これにより、どのタスクが失敗したのかを特定し、適切な対処を行うことが可能です。

以下はその例です。

try
{
    // 非同期処理や並列処理を実行
}
catch (AggregateException ex)
{
    foreach (var innerException in ex.InnerExceptions)
    {
        Console.WriteLine($"個別の例外: {innerException.Message}");
    }
}

Flattenメソッドを使った例外の平坦化

Flattenメソッドを使用することで、AggregateException内のすべての例外を平坦化し、単一のリストとして処理することができます。

これにより、例外の階層構造を気にせずに、すべての例外を一度に処理できます。

try
{
    // 非同期処理や並列処理を実行
}
catch (AggregateException ex)
{
    var flattenedExceptions = ex.Flatten();
    foreach (var exception in flattenedExceptions.InnerExceptions)
    {
        Console.WriteLine($"平坦化された例外: {exception.Message}");
    }
}

Handleメソッドを使った例外のフィルタリング

Handleメソッドを使用することで、特定の条件に基づいて例外をフィルタリングし、処理することができます。

これにより、特定の種類の例外に対してカスタム処理を行うことが可能です。

try
{
    // 非同期処理や並列処理を実行
}
catch (AggregateException ex)
{
    ex.Handle(innerException =>
    {
        if (innerException is InvalidOperationException)
        {
            Console.WriteLine("無効な操作の例外が発生しました。");
            return true; // この例外を処理したことを示す
        }
        return false; // 他の例外は再スロー
    });
}

非同期メソッドでの例外処理

非同期メソッド内でAggregateExceptionが発生した場合、awaitキーワードを使用して例外を捕捉することができます。

以下はその例です。

public async Task ExecuteAsync()
{
    try
    {
        await Task.WhenAll(Task1(), Task2());
    }
    catch (AggregateException ex)
    {
        foreach (var innerException in ex.InnerExceptions)
        {
            Console.WriteLine($"非同期処理での例外: {innerException.Message}");
        }
    }
}

このように、非同期メソッドでもAggregateExceptionを適切に処理することが重要です。

実際のコード例

単純な非同期処理でのAggregateException

以下のコードは、単純な非同期処理を実行し、AggregateExceptionが発生する例です。

2つのタスクのうち1つが例外をスローします。

using System;
using System.Threading.Tasks;
class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            await Task.WhenAll(Task1(), Task2());
        }
        catch (AggregateException ex)
        {
            Console.WriteLine("AggregateExceptionが発生しました。");
            foreach (var innerException in ex.InnerExceptions)
            {
                Console.WriteLine($"例外: {innerException.Message}");
            }
        }
    }
    static async Task Task1()
    {
        await Task.Delay(1000);
        throw new InvalidOperationException("タスク1でエラーが発生しました。");
    }
    static async Task Task2()
    {
        await Task.Delay(500);
        Console.WriteLine("タスク2は正常に完了しました。");
    }
}

AggregateExceptionが発生しました。
例外: タスク1でエラーが発生しました。

複数のタスクでの例外処理

次のコードは、複数のタスクを実行し、各タスクが異なる例外をスローする例です。

using System;
using System.Threading.Tasks;
class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            await Task.WhenAll(Task1(), Task2(), Task3());
        }
        catch (AggregateException ex)
        {
            Console.WriteLine("AggregateExceptionが発生しました。");
            foreach (var innerException in ex.InnerExceptions)
            {
                Console.WriteLine($"例外: {innerException.Message}");
            }
        }
    }
    static async Task Task1()
    {
        await Task.Delay(1000);
        throw new InvalidOperationException("タスク1でエラーが発生しました。");
    }
    static async Task Task2()
    {
        await Task.Delay(500);
        throw new NullReferenceException("タスク2でエラーが発生しました。");
    }
    static async Task Task3()
    {
        await Task.Delay(300);
        Console.WriteLine("タスク3は正常に完了しました。");
    }
}

AggregateExceptionが発生しました。
例外: タスク1でエラーが発生しました。
例外: タスク2でエラーが発生しました。

Flattenメソッドを使った例外処理の例

以下のコードは、Flattenメソッドを使用して、AggregateException内の例外を平坦化して処理する例です。

using System;
using System.Threading.Tasks;
class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            await Task.WhenAll(Task1(), Task2());
        }
        catch (AggregateException ex)
        {
            var flattenedExceptions = ex.Flatten();
            Console.WriteLine("平坦化された例外が発生しました。");
            foreach (var exception in flattenedExceptions.InnerExceptions)
            {
                Console.WriteLine($"例外: {exception.Message}");
            }
        }
    }
    static async Task Task1()
    {
        await Task.Delay(1000);
        throw new InvalidOperationException("タスク1でエラーが発生しました。");
    }
    static async Task Task2()
    {
        await Task.Delay(500);
        throw new NullReferenceException("タスク2でエラーが発生しました。");
    }
}

平坦化された例外が発生しました。
例外: タスク1でエラーが発生しました。
例外: タスク2でエラーが発生しました。

Handleメソッドを使った例外処理の例

次のコードは、Handleメソッドを使用して特定の例外を処理する例です。

using System;
using System.Threading.Tasks;
class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            await Task.WhenAll(Task1(), Task2());
        }
        catch (AggregateException ex)
        {
            ex.Handle(innerException =>
            {
                if (innerException is InvalidOperationException)
                {
                    Console.WriteLine("無効な操作の例外が発生しました。");
                    return true; // この例外を処理したことを示す
                }
                return false; // 他の例外は再スロー
            });
        }
    }
    static async Task Task1()
    {
        await Task.Delay(1000);
        throw new InvalidOperationException("タスク1でエラーが発生しました。");
    }
    static async Task Task2()
    {
        await Task.Delay(500);
        throw new NullReferenceException("タスク2でエラーが発生しました。");
    }
}

無効な操作の例外が発生しました。

このように、Handleメソッドを使用することで、特定の例外に対して柔軟な対応が可能になります。

応用例

非同期プログラミングにおける例外処理のベストプラクティス

非同期プログラミングにおいては、例外処理が特に重要です。

以下のベストプラクティスを考慮することで、より堅牢なアプリケーションを構築できます。

try-catchブロックの使用: 非同期メソッド内で例外が発生する可能性がある場合は、必ずtry-catchブロックを使用して例外を捕捉します。
具体的な例外の捕捉: AggregateExceptionを捕捉した後、InnerExceptionsを使用して具体的な例外を確認し、適切な処理を行います。
ログの記録: 発生した例外をログに記録することで、後から問題を分析しやすくします。
ユーザーへのフィードバック: エラーが発生した場合は、ユーザーに対して適切なメッセージを表示し、アプリケーションの状態を明確にします。

並列処理での例外管理

並列処理を行う際には、複数のタスクが同時に実行されるため、例外管理が複雑になります。

以下のポイントを考慮することが重要です。

タスクの監視: Task.WhenAllを使用して、すべてのタスクの完了を待ち、例外が発生した場合はAggregateExceptionを捕捉します。
個別の例外処理: InnerExceptionsを使用して、各タスクの例外を個別に処理し、必要に応じてリトライやエラーハンドリングを行います。
タスクのキャンセル: タスクがキャンセルされた場合の処理を考慮し、CancellationTokenを使用してキャンセルを管理します。

タスクのキャンセルと例外処理の組み合わせ

タスクのキャンセルと例外処理を組み合わせることで、より柔軟なエラーハンドリングが可能になります。

以下の方法を考慮します。

CancellationTokenの使用: タスクを実行する際にCancellationTokenを渡し、必要に応じてタスクをキャンセルします。
キャンセル時の例外処理: タスクがキャンセルされた場合、OperationCanceledExceptionがスローされるため、これをAggregateException内で処理します。
リトライロジックの実装: 特定の例外が発生した場合にタスクをリトライするロジックを実装し、キャンセルが要求された場合は即座に処理を中断します。

以下は、タスクのキャンセルと例外処理を組み合わせた例です。

using System;
using System.Threading;
using System.Threading.Tasks;
class Program
{
    static async Task Main(string[] args)
    {
        var cts = new CancellationTokenSource();
        try
        {
            var task = Task.Run(() => LongRunningOperation(cts.Token), cts.Token);
            // ここでキャンセルを要求する場合
            // cts.Cancel();
            await task;
        }
        catch (AggregateException ex)
        {
            ex.Handle(innerException =>
            {
                if (innerException is OperationCanceledException)
                {
                    Console.WriteLine("タスクがキャンセルされました。");
                    return true;
                }
                return false;
            });
        }
    }
    static void LongRunningOperation(CancellationToken token)
    {
        for (int i = 0; i < 10; i++)
        {
            token.ThrowIfCancellationRequested();
            Thread.Sleep(1000); // 長時間の処理
        }
    }
}

このように、タスクのキャンセルと例外処理を組み合わせることで、アプリケーションの安定性とユーザー体験を向上させることができます。