レベル1

C# コンパイラ警告 CS1058 の原因と対策について解説

2025-03-29更新日: 2025-03-29

CS1058 警告は、C# の例外処理で先に実行される catch ブロックがすべての例外を捕捉してしまい、後続の catch ブロックが実行されなくなる場合に発生します。

たとえば、最初に catch (System.Exception e) を記述すると、続く catch {} ブロックは一切実行されません。

RuntimeCompatibilityAttribute の設定によって挙動が変わるため、例外処理の順序に注意してください。

目次から探す

CS1058 警告の発生状況
- 例外キャッチブロックの構造
- 例外ラッピングの仕組み
RuntimeCompatibilityAttribute の影響
- 属性の設定内容
- 非 CLS 例外の取り扱い
CS1058 警告に対する対策
- try-catch 構文の見直し
- 属性設定の変更方法
まとめ

CS1058 警告の発生状況

例外キャッチブロックの構造

例外キャッチブロックは、例外処理の際に発生するエラーを捕捉するために使用されます。

たとえば、try-catch 構文では、try ブロック内で発生した例外を特定の catch ブロックで捕捉することができます。

以下のサンプルコードでは、catch (System.Exception e) がまずすべての例外を捕捉するため、その後に記述された catch ブロックは実行されないことになります。

// サンプルコード: 例外キャッチブロックの構造
using System;
class Program
{
    static void Main()
    {
        try
        {
            // エラーを意図的に発生させる
            throw new InvalidOperationException("サンプル例外");
        }
        catch (Exception e)
        {
            // すべての例外を捕捉するので、下記の catch ブロックは到達しない
            Console.WriteLine("例外が捕捉されました: " + e.Message);
        }
        // この catch ブロックは実際には実行されない
        catch
        {
            Console.WriteLine("その他の例外を捕捉");
        }
    }
}

例外が捕捉されました: サンプル例外

このように、どの例外も System.Exception型で捕捉されるため、後続の catch() ブロックが意味を持たなくなる場合があります。

例外ラッピングの仕組み

C# コンパイラは、スローされる非 CLS 例外(すなわち、System.Exception を継承していないオブジェクトの例外)を自動的に System.Runtime.CompilerServices.RuntimeWrappedException型にラップします。

これは CLS 準拠の例外処理を行うための仕組みです。

通常、開発環境で特別な設定を行わなければ、すべての非 CLS 例外はこの仕組みによりラップされ、既存の catch (Exception e) ブロック内で捕捉されます。

そのため、catch ブロックの記述順序によっては、意図しない動作になる可能性があります。

特に、catch (System.Exception e) の後に catch() ブロックを記述すると、実行されない部分が存在し、CS1058 警告が出力されます。

RuntimeCompatibilityAttribute の影響

属性の設定内容

RuntimeCompatibilityAttribute は、コンパイラの例外処理にどのような挙動をさせるかを制御する属性です。

デフォルトでは、WrapNonExceptionThrowsプロパティが true に設定され、非 CLS 例外を自動的にラップします。

これにより、catch (Exception e) によってすべての例外を一律に捕捉することが可能になる一方で、後続の catch ブロックが到達不能となるケースが発生します。

プロジェクトの AssemblyInfo.cs などでこの属性を設定することができ、次のように記述されます。

// AssemblyInfo.cs の例
using System.Runtime.CompilerServices;
[assembly: RuntimeCompatibilityAttribute(WrapNonExceptionThrows = true)]

この設定により、開発者は例外ラッピングの動作が CLS に準拠していることを保証し、統一した例外処理が可能となります。

WrapNonExceptionThrows の詳細

WrapNonExceptionThrowsプロパティは、スローされたオブジェクトが System.Exception を継承していない場合にその例外を RuntimeWrappedException に変換するかどうかを制御します。

具体的には、

$W r a p N o n E x c e p t i o n T h r o w s = t r u e$ の場合、非 CLS 例外はすべて RuntimeWrappedException にラップされ、既存の catch (Exception e) ブロックで捕捉される。
$W r a p N o n E x c e p t i o n T h r o w s = f a l s e$ に設定すると、非 CLS 例外はラップされずにそのままスローされるため、対応する catch ブロックで個別にキャッチすることが可能となる。

以下のサンプルコードは、デフォルト設定での動作を示しています。

// サンプルコード: WrapNonExceptionThrows の動作確認
using System;
using System.Runtime.CompilerServices;
[assembly: RuntimeCompatibilityAttribute(WrapNonExceptionThrows = true)]
class SampleProgram
{
    static void Main()
    {
        try
        {
            // 整数を例外としてスロー(非 CLS 例外)
            throw "非 CLS 例外発生";
        }
        catch (Exception e)
        {
            // 例外は RuntimeWrappedException にラップされるため、ここで捕捉される
            Console.WriteLine("ラップされた例外が捕捉されました: " + e.GetType().Name);
        }
    }
}

ラップされた例外が捕捉されました: RuntimeWrappedException

非 CLS 例外の取り扱い

非 CLS 例外は、C# の設計上、すべての例外が System.Exception を継承しているわけではないため、独自の処理が必要となる場合があります。

WrapNonExceptionThrows の設定によって、非 CLS 例外が RuntimeWrappedException により処理されるため、通常の catch (Exception e) ブロックで捕捉できるようになっています。

しかし、例外の取り扱いに関して厳密な制御が求められる場合は、ラッピングせずに元の例外オブジェクトそのままキャッチする設定に変更する方法もあります。

これにより、例外の詳細をより正確に把握することが可能になります。

CS1058 警告に対する対策

try-catch 構文の見直し

CS1058 警告は、先に配置された catch (Exception e) ブロックがすべての例外を捕捉しているため、後続の catch() ブロックが実行不可能となる場合に発生します。

対策としては、catch ブロックの順序を見直し、具体的な例外を先に捕捉するように変更することが有効です。

キャッチブロックの順序調整

具体例として、特定の例外(たとえば、InvalidOperationException)を先に捕捉し、その後に一般的な Exception型をキャッチするように変更する方法があります。

次のサンプルコードは、キャッチブロックの順序を適切に調整する例です。

// サンプルコード: キャッチブロックの順序調整
using System;
class ExceptionHandlingSample
{
    static void Main()
    {
        try
        {
            // 故意に例外を発生させる
            throw new InvalidOperationException("特定の例外発生");
        }
        catch (InvalidOperationException ex)
        {
            // 特定例外を先に捕捉
            Console.WriteLine("InvalidOperationException を捕捉: " + ex.Message);
        }
        catch (Exception ex)
        {
            // 残りの例外を捕捉
            Console.WriteLine("一般例外を捕捉: " + ex.Message);
        }
    }
}

InvalidOperationException を捕捉: 特定の例外発生

このように、特定の例外を優先的に処理することで、不要な CS1058 警告が発生するのを防ぐことができます。

属性設定の変更方法

もう1つの対策は、RuntimeCompatibilityAttribute の設定変更です。

WrapNonExceptionThrows を false に設定することで、非 CLS 例外がラップされずにそのままスローされ、通常の例外処理とは異なるキャッチ戦略を取ることが可能です。

この変更は、プロジェクトの AssemblyInfo.cs や個別ソースコードに明示的に記述します。

// サンプルコード: 属性設定変更による対策
using System;
using System.Runtime.CompilerServices;
// 非 CLS 例外をラップせずにそのままスローする設定に変更
[assembly: RuntimeCompatibilityAttribute(WrapNonExceptionThrows = false)]
class AttributeSample
{
    static void Main()
    {
        try
        {
            // 非 CLS 例外として文字列をスロー
            throw "非 CLS 例外発生";
        }
        // RuntimeWrappedException ではなく、元の例外を捕捉しようとするためエラーとなる場合がある
        catch (Exception ex)
        {
            Console.WriteLine("例外を捕捉: " + ex.GetType().Name);
        }
        // 明示的な catch ブロックを追加することで、非 CLS 例外にも対応することが可能
        catch
        {
            Console.WriteLine("非 CLS 例外を捕捉");
        }
    }
}

非 CLS 例外を捕捉

このような設定変更により、例外処理の挙動を柔軟に制御できるため、利用シーンに合わせた適切な例外処理設計が可能となります。

まとめ

この記事では、C#のコンパイラ警告CS1058の原因となる例外キャッチブロックの構造と例外ラッピングの仕組みについて解説しています。

さらに、RuntimeCompatibilityAttributeの設定、特にWrapNonExceptionThrowsの役割や非 CLS 例外の取り扱いを詳しく説明し、catchブロックの順序調整や属性設定の変更による対策方法を示しました。

これにより、CS1058警告発生の背景とその対策について理解が深まります。