C#の連鎖例外（Chained Exceptions）とは？基本的な使い方と実装例を解説

連鎖例外とは

連鎖例外（Chained Exceptions）とは、複数のtry-catch文が連鎖的に組み合わさり、発生した例外を順番に処理しながら上位の呼び出し元へ伝播させていく仕組みです。C#では、新しい例外をスローするときにコンストラクタの第2引数として元の例外（内部例外：InnerException）を渡すことで、例外同士をチェーンのようにつなぐことができます。

これにより、「どこで・どのような原因で」例外が発生したのかという情報を失うことなく、呼び出し階層全体で例外を追跡できるようになります。

それでは、実際に連鎖例外を作成してみましょう。まずは、エントリポイントであるMainメソッドに最初のtry-catchを設定します。

例

static void Main(string[] args) {
   try {
      One();
   } catch (Exception e) {
      Console.WriteLine(e);
   }
}

次に、メソッドOne()の中にtry-catchを実装します。ここでキャッチした例外は、そのまま握りつぶさずに、新しい例外へラップして再スローするのがポイントです。

例

static void One() {
   try {
      Two();
   } catch (Exception e) {
      throw new Exception("First exception!", e);
   }
}

メソッドTwo()でも同じように、さらに次のメソッドを呼び出し、キャッチした例外を新しい例外に包んで投げることで、例外の連鎖が続いていきます。

例

static void Two() {
   try {
      Three();
   } catch (Exception e) {
      throw new Exception("Second Exception!", e);
   }
}

続いて、次のメソッドThree()も同様の構造になっています。

例

static void Three() {
   try {
      Last();
   } catch (Exception e) {
      throw new Exception("Third Exception!", e);
   }
}

最後に、連鎖の起点となるLast()メソッドです。ここで最初の例外が発生します。

例

static void Last() {
   throw new Exception("Last exception!");
}

実行結果

上記のコードを実行すると、各メソッドで例外がラップされながら伝播し、最終的にMainメソッドのcatchブロックでまとめて出力されます。実行結果は以下のようになります。

System.Exception: First exception! ---< System.Exception: Middle Exception! ---< System.Exception: Last exception!
at Demo.Two () [0x00000] in <199744cb72714131b4f5995ddd1a021f>:0
--- End of inner exception stack trace ---
at Demo.Two () [0x00016] in <199744cb72714131b4f5995ddd1a021f>:0
at Demo.One () [0x00000] in <199744cb72714131b4f5995ddd1a021f>:0
--- End of inner exception stack trace ---
at Demo.One () [0x00016] in <199744cb72714131b4f5995ddd1a021f>:0
at Demo.Main (System.String[] args) [0x00000] in <199744cb72714131b4f5995ddd1a021f>:0

まとめ

このように、例外を再スローする際に元の例外を引数として渡すことで、例外の発生源から最終的な処理場所まで、スタックトレースの情報を保ったまま例外を連鎖させることができます。デバッグやログ出力の際に原因を特定しやすくなるため、大規模なアプリケーション開発では非常に有用なテクニックです。