AppDomain.UnhandledException

.NET Framework クラス ライブラリ リファレンス

AppDomain.UnhandledException イベント

例外がキャッチされない場合に発生します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Event UnhandledException As
 UnhandledExceptionEventHandler

Visual Basic (使用法)

Dim instance As AppDomain
Dim handler As UnhandledExceptionEventHandler

AddHandler instance.UnhandledException, handler

C#

public event UnhandledExceptionEventHandler UnhandledException

C++

public:
virtual event UnhandledExceptionEventHandler^ UnhandledException {
    void add (UnhandledExceptionEventHandler^ value) sealed;
    void remove (UnhandledExceptionEventHandler^ value) sealed;
}

J#

/** @event */
public final void add_UnhandledException (UnhandledExceptionEventHandler
 value)

/** @event */
public final void remove_UnhandledException
 (UnhandledExceptionEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、キャッチされない例外の通知を提供します。このイベントにより、システムの既定のハンドラが例外をユーザーに報告し、アプリケーションを終了する前に、アプリケーションで例外に関する情報を記録できます。アプリケーションの状態に関する十分な情報を使用できる場合、後で回復に使用するためにプログラム データを保存するなど、その他のアクションが実行される場合もあります。未処理の例外により、プログラム データが回復できないほど破損する可能性があるため、警告が発信されます。

メモ
.NET Framework Version 1.0 および 1.1 では、このイベントが発生する前に、アプリケーションの終了とデバッグ オプションがユーザーに報告されます。

このイベントは、任意のアプリケーション ドメインで処理できます。既定のアプリケーション ドメインで処理される場合、このイベントは、すべてのアプリケーション ドメイン内のすべての未処理の例外に対して発生します。子ドメインで処理される場合、このイベントは、そのドメイン内の未処理の例外に対してだけ発生します。イベントが既定のドメインと子ドメインの両方で処理される場合、子ドメインの未処理の例外により、両方のドメインでこのイベントが発生します。

メモ
.NET Framework Version 1.0 および 1.1 では、このイベントは、アプリケーションの起動時にシステムによって作成されたアプリケーション ドメインに対してだけ発生します。アプリケーションが追加のアプリケーション ドメインを作成する場合、それらの追加アプリケーション ドメインでこのイベントのデリゲートを指定しても無効です。

.NET Framework Version 1.0 および 1.1 では、メイン アプリケーション スレッド以外のスレッドで発生した未処理の例外は、ランタイムによってキャッチされたため、アプリケーションは終了しませんでした。したがって、アプリケーションを終了しなくても、UnhandledException イベントが発生しました。.NET Framework Version 2.0 では、このような応答のない障害が累積するとパフォーマンスの低下、データの破損、およびロックアップを招き、これらはすべてデバッグが難しいため、子スレッドの未処理の例外用のこのバックストップは削除されました。詳細については、「マネージ スレッドの例外」を参照してください。

このイベントのイベント ハンドラを登録するには、適切なアクセス許可が必要です。アクセス許可がないと、SecurityException がスローされます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

UnhandledException イベントのサンプルを次に示します。

Visual Basic

Sub Main()
   Dim currentDomain As AppDomain = AppDomain.CurrentDomain
   AddHandler currentDomain.UnhandledException, AddressOf
 MyHandler
   
   Try
      Throw New Exception("1")
   Catch e As Exception
      Console.WriteLine("Catch clause caught : " +
 e.Message)
   End Try
   
   Throw New Exception("2")

   ' Output:
   '   Catch clause caught : 1
   '   MyHandler caught : 2
End Sub 'Main


Sub MyHandler(sender As Object,
 args As UnhandledExceptionEventArgs)
   Dim e As Exception = DirectCast(args.ExceptionObject,
 Exception)
   Console.WriteLine("MyHandler caught : " + e.Message)
End Sub 'MyUnhandledExceptionEventHandler

C#

using System;
using System.Security.Permissions;

public class Test {

   [SecurityPermission(SecurityAction.Demand, Flags=SecurityPermissionFlag.ControlAppDomain)]
   public static void Example()
   {
      AppDomain currentDomain = AppDomain.CurrentDomain;
      currentDomain.UnhandledException += new UnhandledExceptionEventHandler(MyHandler);
      
      try {
         throw new Exception("1");
      } catch (Exception e) {
         Console.WriteLine("Catch clause caught : " + e.Message);
      }

      throw new Exception("2");

      // Output:
      //   Catch clause caught : 1
      //   MyHandler caught : 2
   }
   
   static void MyHandler(object sender, UnhandledExceptionEventArgs
 args) {
      Exception e = (Exception) args.ExceptionObject;
      Console.WriteLine("MyHandler caught : " + e.Message);
   }

   public static void Main()
 {
      Example();
   }
}

C++

public ref class Test
{
private:
   static void MyHandler( Object^ /*sender*/,
 UnhandledExceptionEventArgs^ args )
   {
      Exception^ e = dynamic_cast<Exception^>(args->ExceptionObject);
      Console::WriteLine( "MyHandler caught : {0}", e->Message );
   }
public: 
   [SecurityPermissionAttribute( SecurityAction::Demand, ControlAppDomain = true
 )]
   static void Main()
   {
   AppDomain^ currentDomain = AppDomain::CurrentDomain;
   currentDomain->UnhandledException += gcnew UnhandledExceptionEventHandler(
 Test::MyHandler );
   try
   {
      throw gcnew Exception( "1" );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Catch clause caught : {0}", e->Message );
   }

   throw gcnew Exception( "2" );
   
   // Output:
   //   Catch clause caught : 1
   //   MyHandler caught : 2
   }
};

int main()
{
   Test::Main();
}

.NET Framework のセキュリティ

• SecurityPermission  (このイベントのイベント ハンドラを追加するために必要なアクセス許可)。SecurityPermissionFlag.ControlAppDomain (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
AppDomain クラス
AppDomain メンバ
System 名前空間

_AppDomain.UnhandledException イベント

COM オブジェクトに、AppDomain.UnhandledException イベントへのバージョンに依存しないアクセスが用意されています。

このイベントは、CLS に準拠していません。  

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Event UnhandledException As UnhandledExceptionEventHandler

Visual Basic (使用法)

Dim instance As _AppDomain
Dim handler As UnhandledExceptionEventHandler

AddHandler instance.UnhandledException, handler

C#

event UnhandledExceptionEventHandler UnhandledException

C++

event UnhandledExceptionEventHandler^ UnhandledException {
    void add (UnhandledExceptionEventHandler^ value);
    void remove (UnhandledExceptionEventHandler^ value);
}

J#

/** @event */
void add_UnhandledException (UnhandledExceptionEventHandler value)

/** @event */
void remove_UnhandledException (UnhandledExceptionEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

詳細については、AppDomain.UnhandledException イベントのトピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
_AppDomain インターフェイス
_AppDomain メンバ
System 名前空間