CA2102: 汎用ハンドラーの CLSCompliant でない例外をキャッチします

原因

アセンブリ内の RuntimeCompatibilityAttribute でマークされていないメンバーまたは RuntimeCompatibility(WrapNonExceptionThrows = false) でマークされているメンバーには、System.Exception を処理する catch ブロックがあり、その直後に汎用 catch ブロックはありません。 この規則は、Visual Basic アセンブリを無視します。

規則の説明

Exception を処理する catch ブロックは、共通言語仕様 (CLS: Common Language Specification) に準拠した例外はすべてキャッチしますが、 CLS に準拠しない例外はキャッチしません。 CLS に準拠しない例外は、ネイティブ コードや Microsoft Intermediate Language (MSIL) アセンブラーで生成されたマネージ コードからスローされます。 ただし、C# コンパイラおよび Visual Basic コンパイラでは CLS に準拠しない例外をスローできず、Visual Basic は CLS に準拠しない例外をキャッチしません。 catch ブロックによってすべての例外を処理する場合は、次の汎用 catch ブロック構文を使用します。

• C#: catch {}

• C++: catch(...) {} または catch(Object^) {}

以前に許可されたアクセス許可が catch ブロックから削除されると、CLS に準拠しない未処理の例外がセキュリティ問題に変わります。 CLS に準拠しない例外はキャッチされないため、CLS に準拠しない例外をスローする悪意のあるメソッドを昇格したアクセス許可で実行できることがあります。

違反の修正方法

すべての例外のキャッチを目的とする場合に、この規則違反を修正するには、汎用 catch ブロックを代用または追加するか、アセンブリを RuntimeCompatibility(WrapNonExceptionThrows = true) とマークします。 catch ブロック内のアクセス許可が削除された場合は、汎用 catch ブロック内の機能を複製します。 すべての例外の処理を目的としない場合は、Exception を処理する catch ブロックを削除し、代わりに特定の種類の例外を処理する catch ブロックを追加します。

警告を抑制する状況

CLS に準拠しない例外を生成する可能性のあるステートメントが try ブロックに含まれていない場合は、この規則による警告を抑制しても安全です。 ネイティブ コードやマネージ コードは CLS に準拠しない例外をスローする可能性があるため、try ブロック内の各コード パスで実行されるコードをすべて把握している必要があります。 ただし、共通言語ランタイムは CLS に準拠しない例外をスローしません。

使用例

次の例は、CLS に準拠しない例外をスローする MSIL クラスを示しています。

.assembly ThrowNonClsCompliantException {}
.class public auto ansi beforefieldinit ThrowsExceptions
{
   .method public hidebysig static void
         ThrowNonClsException() cil managed
   {
      .maxstack  1
      IL_0000:  newobj     instance void [mscorlib]System.Object::.ctor()
      IL_0005:  throw
   }
}

次の例は、この規則に準拠する汎用 catch ブロックを含むメソッド示しています。

// CatchNonClsCompliantException.cs
using System;

namespace SecurityLibrary
{
   class HandlesExceptions
   {
      void CatchAllExceptions()
      {
         try
         {
            ThrowsExceptions.ThrowNonClsException();
         }
         catch(Exception e)
         {
            // Remove some permission.
            Console.WriteLine("CLS compliant exception caught");
         }
         catch
         {
            // Remove the same permission as above.
            Console.WriteLine("Non-CLS compliant exception caught.");
         }
      }

      static void Main()
      {
         HandlesExceptions handleExceptions = new HandlesExceptions();
         handleExceptions.CatchAllExceptions();
      }
   }
}

上記のコード例を次のようにコンパイルします。

ilasm /dll ThrowNonClsCompliantException.il
csc /r:ThrowNonClsCompliantException.dll CatchNonClsCompliantException.cs

関連規則

CA1031: 一般的な例外の種類はキャッチしません

参照

参照

例外と例外処理 (C# プログラミング ガイド)

Ilasm.exe (MSIL アセンブラー)

概念

セキュリティ チェックのオーバーライド

共通言語仕様