Application.SetUnhandledExceptionMode Application.SetUnhandledExceptionMode Application.SetUnhandledExceptionMode Application.SetUnhandledExceptionMode Method

定義

未処理の例外への対応方法をアプリケーションに指示します。Instructs the application how to respond to unhandled exceptions.

オーバーロード

SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode)

未処理の例外への対応方法をアプリケーションに指示します。Instructs the application how to respond to unhandled exceptions.

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

未処理の例外に応答する方法をアプリケーションに指示し、オプションでスレッド固有の動作を適用します。Instructs the application how to respond to unhandled exceptions, optionally applying thread-specific behavior.

次のコード例では、Windows フォーム スレッドと他のスレッドで発生する例外の発生する例外のイベント ハンドラーを設定します。The following code example sets event handlers for exceptions that occur on Windows Forms threads and exceptions that occur on other threads. 設定SetUnhandledExceptionModeすべての例外は、アプリケーションのユーザー構成ファイルの設定に関係なく、アプリケーションによって処理されるようにします。It sets SetUnhandledExceptionMode so that all exceptions are handled by the application, regardless of the settings in the application's user configuration file. 使用して、 ThreadException UI スレッドの例外を処理するイベントとUnhandledException非 UI スレッドの例外を処理するイベントです。It uses the ThreadException event to handle UI thread exceptions, and the UnhandledException event to handle non-UI thread exceptions. UnhandledExceptionアプリケーションを防ぐことはできませんの終了、例では、単にエラーがログに終了する前に、アプリケーション イベント ログ。Since UnhandledException cannot prevent an application from terminating, the example simply logs the error in the application event log before termination.

この例では、2 つを定義したButtonコントロール、button1button2Formクラス。This example assumes that you have defined two Button controls, button1 and button2, on your Form class.

   // Creates a class to throw the error.
public:
   ref class ErrorHandler: public System::Windows::Forms::Form
   {
      // Inserts the code to create a form with a button.

      // Programs the button to throw an exception when clicked.
   private:
      void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      {
         throw gcnew ArgumentException( "The parameter was invalid" );
      }

   public:
      static void Main()
      {
         // Creates an instance of the methods that will handle the exception.
         CustomExceptionHandler ^ eh = gcnew CustomExceptionHandler;
         
         // Adds the event handler to the event.
         Application::ThreadException += gcnew ThreadExceptionEventHandler( eh, &Form1::CustomExceptionHandler::OnThreadException );
         
         // Runs the application.
         Application::Run( gcnew ErrorHandler );
      }
   };

   // Creates a class to handle the exception event.
internal:
   ref class CustomExceptionHandler
   {
      // Handles the exception event.
   public:
      void OnThreadException( Object^ /*sender*/, ThreadExceptionEventArgs^ t )
      {
         System::Windows::Forms::DialogResult result = ::DialogResult::Cancel;
         try
         {
            result = this->ShowThreadExceptionDialog( t->Exception );
         }
         catch ( Exception^ ) 
         {
            try
            {
               MessageBox::Show( "Fatal Error", "Fatal Error", MessageBoxButtons::AbortRetryIgnore, MessageBoxIcon::Stop );
            }
            finally
            {
               Application::Exit();
            }
         }
         
         // Exits the program when the user clicks Abort.
         if ( result == ::DialogResult::Abort )
         {
            Application::Exit();
         }
      }

      // Creates the error message and displays it.
   private:
      System::Windows::Forms::DialogResult ShowThreadExceptionDialog( Exception^ e )
      {
         String^ errorMsg = "An error occurred please contact the adminstrator with the following information:\n\n";
         errorMsg = String::Concat( errorMsg, e->Message, "\n\nStack Trace:\n", e->StackTrace );
         return MessageBox::Show( errorMsg, "Application Error", MessageBoxButtons::AbortRetryIgnore, MessageBoxIcon::Stop );
      }
   };
Thread newThread = null;

// Starts the application. 
[SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.ControlAppDomain)]
public static void Main(string[] args)
{
    // Add the event handler for handling UI thread exceptions to the event.
    Application.ThreadException += new ThreadExceptionEventHandler(ErrorHandlerForm.Form1_UIThreadException);

    // Set the unhandled exception mode to force all Windows Forms errors to go through
    // our handler.
    Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);

    // Add the event handler for handling non-UI thread exceptions to the event. 
    AppDomain.CurrentDomain.UnhandledException +=
        new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);

    // Runs the application.
    Application.Run(new ErrorHandlerForm());
}

// Programs the button to throw an exception when clicked.
private void button1_Click(object sender, System.EventArgs e)
{
    throw new ArgumentException("The parameter was invalid");
}

// Start a new thread, separate from Windows Forms, that will throw an exception.
private void button2_Click(object sender, System.EventArgs e)
{
    ThreadStart newThreadStart = new ThreadStart(newThread_Execute);
    newThread = new Thread(newThreadStart);
    newThread.Start();
}

// The thread we start up to demonstrate non-UI exception handling. 
void newThread_Execute()
{
    throw new Exception("The method or operation is not implemented.");
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
private static void Form1_UIThreadException(object sender, ThreadExceptionEventArgs t)
{
    DialogResult result = DialogResult.Cancel;
    try
    {
        result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception);
    }
    catch
    {
        try
        {
            MessageBox.Show("Fatal Windows Forms Error",
                "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }

    // Exits the program when the user clicks Abort.
    if (result == DialogResult.Abort)
        Application.Exit();
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
// NOTE: This exception cannot be kept from terminating the application - it can only 
// log the event, and inform the user about it. 
private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    try
    {
        Exception ex = (Exception)e.ExceptionObject;
        string errorMsg = "An application error occurred. Please contact the adminstrator " +
            "with the following information:\n\n";

        // Since we can't prevent the app from terminating, log this to the event log.
        if (!EventLog.SourceExists("ThreadException"))
        {
            EventLog.CreateEventSource("ThreadException", "Application");
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "ThreadException";
        myLog.WriteEntry(errorMsg + ex.Message + "\n\nStack Trace:\n" + ex.StackTrace);
    }
    catch (Exception exc)
    {
        try
        {
            MessageBox.Show("Fatal Non-UI Error",
                "Fatal Non-UI Error. Could not write the error to the event log. Reason: "
                + exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }
}

// Creates the error message and displays it.
private static DialogResult ShowThreadExceptionDialog(string title, Exception e)
{
    string errorMsg = "An application error occurred. Please contact the adminstrator " +
        "with the following information:\n\n";
    errorMsg = errorMsg + e.Message + "\n\nStack Trace:\n" + e.StackTrace;
    return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore,
        MessageBoxIcon.Stop);
}
     Private newThread As Thread = Nothing

     ' Starts the application. 
     <SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlAppDomain)> _
     Public Shared Sub Main()
         ' Add the event handler for handling UI thread exceptions to the event.
         AddHandler Application.ThreadException, AddressOf ErrorHandlerForm.Form1_UIThreadException

         ' Set the unhandled exception mode to force all Windows Forms errors to go through
         ' our handler.
         Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException)

         ' Add the event handler for handling non-UI thread exceptions to the event. 
         AddHandler AppDomain.CurrentDomain.UnhandledException, AddressOf CurrentDomain_UnhandledException

         ' Runs the application.
         Application.Run(New ErrorHandlerForm())
     End Sub


     ' Programs the button to throw an exception when clicked.
     Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
         Throw New ArgumentException("The parameter was invalid")
     End Sub

     ' Start a new thread, separate from Windows Forms, that will throw an exception.
     Private Sub button2_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button2.Click
         Dim newThreadStart As New ThreadStart(AddressOf newThread_Execute)
         newThread = New Thread(newThreadStart)
         newThread.Start()
     End Sub


     ' The thread we start up to demonstrate non-UI exception handling. 
     Sub newThread_Execute()
         Throw New Exception("The method or operation is not implemented.")
     End Sub


     ' Handle the UI exceptions by showing a dialog box, and asking the user whether
     ' or not they wish to abort execution.
     Private Shared Sub Form1_UIThreadException(ByVal sender As Object, ByVal t As ThreadExceptionEventArgs)
         Dim result As System.Windows.Forms.DialogResult = _
             System.Windows.Forms.DialogResult.Cancel
         Try
             result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception)
         Catch
             Try
                 MessageBox.Show("Fatal Windows Forms Error", _
                     "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop)
             Finally
                 Application.Exit()
             End Try
         End Try

         ' Exits the program when the user clicks Abort.
         If result = DialogResult.Abort Then
             Application.Exit()
         End If
     End Sub

     ' Handle the UI exceptions by showing a dialog box, and asking the user whether
     ' or not they wish to abort execution.
     ' NOTE: This exception cannot be kept from terminating the application - it can only 
     ' log the event, and inform the user about it. 
     Private Shared Sub CurrentDomain_UnhandledException(ByVal sender As Object, _
     ByVal e As UnhandledExceptionEventArgs)
         Try
             Dim ex As Exception = CType(e.ExceptionObject, Exception)
             Dim errorMsg As String = "An application error occurred. Please contact the adminstrator " & _
                 "with the following information:" & ControlChars.Lf & ControlChars.Lf

             ' Since we can't prevent the app from terminating, log this to the event log.
             If (Not EventLog.SourceExists("ThreadException")) Then
                 EventLog.CreateEventSource("ThreadException", "Application")
             End If

             ' Create an EventLog instance and assign its source.
             Dim myLog As New EventLog()
             myLog.Source = "ThreadException"
             myLog.WriteEntry((errorMsg + ex.Message & ControlChars.Lf & ControlChars.Lf & _
                 "Stack Trace:" & ControlChars.Lf & ex.StackTrace))
         Catch exc As Exception
             Try
                 MessageBox.Show("Fatal Non-UI Error", "Fatal Non-UI Error. Could not write the error to the event log. " & _
                     "Reason: " & exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop)
             Finally
                 Application.Exit()
             End Try
         End Try
     End Sub


     ' Creates the error message and displays it.
     Private Shared Function ShowThreadExceptionDialog(ByVal title As String, ByVal e As Exception) As DialogResult
         Dim errorMsg As String = "An application error occurred. Please contact the adminstrator " & _
"with the following information:" & ControlChars.Lf & ControlChars.Lf
         errorMsg = errorMsg & e.Message & ControlChars.Lf & _
ControlChars.Lf & "Stack Trace:" & ControlChars.Lf & e.StackTrace

         Return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop)
     End Function

SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode)

未処理の例外への対応方法をアプリケーションに指示します。Instructs the application how to respond to unhandled exceptions.

public:
 static void SetUnhandledExceptionMode(System::Windows::Forms::UnhandledExceptionMode mode);
public static void SetUnhandledExceptionMode (System.Windows.Forms.UnhandledExceptionMode mode);
static member SetUnhandledExceptionMode : System.Windows.Forms.UnhandledExceptionMode -> unit
Public Shared Sub SetUnhandledExceptionMode (mode As UnhandledExceptionMode)

パラメーター

mode
UnhandledExceptionMode UnhandledExceptionMode UnhandledExceptionMode UnhandledExceptionMode

キャッチされない例外がスローされた場合に必要なアプリケーションの動作方法を説明する UnhandledExceptionMode 値。An UnhandledExceptionMode value describing how the application should behave if an exception is thrown without being caught.

例外

アプリケーションが最初のウィンドウを作成した後、例外モードを設定することはできません。You cannot set the exception mode after the application has created its first window.

次のコード例では、Windows フォーム スレッドと他のスレッドで発生する例外の発生する例外のイベント ハンドラーを設定します。The following code example sets event handlers for exceptions that occur on Windows Forms threads and exceptions that occur on other threads. 設定SetUnhandledExceptionModeすべての例外は、アプリケーションのユーザー構成ファイルの設定に関係なく、アプリケーションによって処理されるようにします。It sets SetUnhandledExceptionMode so that all exceptions are handled by the application, regardless of the settings in the application's user configuration file. 使用して、 ThreadException UI スレッドの例外を処理するイベントとUnhandledException非 UI スレッドの例外を処理するイベントです。It uses the ThreadException event to handle UI thread exceptions, and the UnhandledException event to handle non-UI thread exceptions. UnhandledExceptionアプリケーションを防ぐことはできませんの終了、例では、単にエラーがログに終了する前に、アプリケーション イベント ログ。Since UnhandledException cannot prevent an application from terminating, the example simply logs the error in the application event log before termination.

この例では、2 つを定義したButtonコントロール、button1button2Formクラス。This example assumes that you have defined two Button controls, button1 and button2, on your Form class.

   // Creates a class to throw the error.
public:
   ref class ErrorHandler: public System::Windows::Forms::Form
   {
      // Inserts the code to create a form with a button.

      // Programs the button to throw an exception when clicked.
   private:
      void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      {
         throw gcnew ArgumentException( "The parameter was invalid" );
      }

   public:
      static void Main()
      {
         // Creates an instance of the methods that will handle the exception.
         CustomExceptionHandler ^ eh = gcnew CustomExceptionHandler;
         
         // Adds the event handler to the event.
         Application::ThreadException += gcnew ThreadExceptionEventHandler( eh, &Form1::CustomExceptionHandler::OnThreadException );
         
         // Runs the application.
         Application::Run( gcnew ErrorHandler );
      }
   };

   // Creates a class to handle the exception event.
internal:
   ref class CustomExceptionHandler
   {
      // Handles the exception event.
   public:
      void OnThreadException( Object^ /*sender*/, ThreadExceptionEventArgs^ t )
      {
         System::Windows::Forms::DialogResult result = ::DialogResult::Cancel;
         try
         {
            result = this->ShowThreadExceptionDialog( t->Exception );
         }
         catch ( Exception^ ) 
         {
            try
            {
               MessageBox::Show( "Fatal Error", "Fatal Error", MessageBoxButtons::AbortRetryIgnore, MessageBoxIcon::Stop );
            }
            finally
            {
               Application::Exit();
            }
         }
         
         // Exits the program when the user clicks Abort.
         if ( result == ::DialogResult::Abort )
         {
            Application::Exit();
         }
      }

      // Creates the error message and displays it.
   private:
      System::Windows::Forms::DialogResult ShowThreadExceptionDialog( Exception^ e )
      {
         String^ errorMsg = "An error occurred please contact the adminstrator with the following information:\n\n";
         errorMsg = String::Concat( errorMsg, e->Message, "\n\nStack Trace:\n", e->StackTrace );
         return MessageBox::Show( errorMsg, "Application Error", MessageBoxButtons::AbortRetryIgnore, MessageBoxIcon::Stop );
      }
   };
Thread newThread = null;

// Starts the application. 
[SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.ControlAppDomain)]
public static void Main(string[] args)
{
    // Add the event handler for handling UI thread exceptions to the event.
    Application.ThreadException += new ThreadExceptionEventHandler(ErrorHandlerForm.Form1_UIThreadException);

    // Set the unhandled exception mode to force all Windows Forms errors to go through
    // our handler.
    Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);

    // Add the event handler for handling non-UI thread exceptions to the event. 
    AppDomain.CurrentDomain.UnhandledException +=
        new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);

    // Runs the application.
    Application.Run(new ErrorHandlerForm());
}

// Programs the button to throw an exception when clicked.
private void button1_Click(object sender, System.EventArgs e)
{
    throw new ArgumentException("The parameter was invalid");
}

// Start a new thread, separate from Windows Forms, that will throw an exception.
private void button2_Click(object sender, System.EventArgs e)
{
    ThreadStart newThreadStart = new ThreadStart(newThread_Execute);
    newThread = new Thread(newThreadStart);
    newThread.Start();
}

// The thread we start up to demonstrate non-UI exception handling. 
void newThread_Execute()
{
    throw new Exception("The method or operation is not implemented.");
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
private static void Form1_UIThreadException(object sender, ThreadExceptionEventArgs t)
{
    DialogResult result = DialogResult.Cancel;
    try
    {
        result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception);
    }
    catch
    {
        try
        {
            MessageBox.Show("Fatal Windows Forms Error",
                "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }

    // Exits the program when the user clicks Abort.
    if (result == DialogResult.Abort)
        Application.Exit();
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
// NOTE: This exception cannot be kept from terminating the application - it can only 
// log the event, and inform the user about it. 
private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    try
    {
        Exception ex = (Exception)e.ExceptionObject;
        string errorMsg = "An application error occurred. Please contact the adminstrator " +
            "with the following information:\n\n";

        // Since we can't prevent the app from terminating, log this to the event log.
        if (!EventLog.SourceExists("ThreadException"))
        {
            EventLog.CreateEventSource("ThreadException", "Application");
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "ThreadException";
        myLog.WriteEntry(errorMsg + ex.Message + "\n\nStack Trace:\n" + ex.StackTrace);
    }
    catch (Exception exc)
    {
        try
        {
            MessageBox.Show("Fatal Non-UI Error",
                "Fatal Non-UI Error. Could not write the error to the event log. Reason: "
                + exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }
}

// Creates the error message and displays it.
private static DialogResult ShowThreadExceptionDialog(string title, Exception e)
{
    string errorMsg = "An application error occurred. Please contact the adminstrator " +
        "with the following information:\n\n";
    errorMsg = errorMsg + e.Message + "\n\nStack Trace:\n" + e.StackTrace;
    return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore,
        MessageBoxIcon.Stop);
}
     Private newThread As Thread = Nothing

     ' Starts the application. 
     <SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlAppDomain)> _
     Public Shared Sub Main()
         ' Add the event handler for handling UI thread exceptions to the event.
         AddHandler Application.ThreadException, AddressOf ErrorHandlerForm.Form1_UIThreadException

         ' Set the unhandled exception mode to force all Windows Forms errors to go through
         ' our handler.
         Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException)

         ' Add the event handler for handling non-UI thread exceptions to the event. 
         AddHandler AppDomain.CurrentDomain.UnhandledException, AddressOf CurrentDomain_UnhandledException

         ' Runs the application.
         Application.Run(New ErrorHandlerForm())
     End Sub


     ' Programs the button to throw an exception when clicked.
     Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
         Throw New ArgumentException("The parameter was invalid")
     End Sub

     ' Start a new thread, separate from Windows Forms, that will throw an exception.
     Private Sub button2_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button2.Click
         Dim newThreadStart As New ThreadStart(AddressOf newThread_Execute)
         newThread = New Thread(newThreadStart)
         newThread.Start()
     End Sub


     ' The thread we start up to demonstrate non-UI exception handling. 
     Sub newThread_Execute()
         Throw New Exception("The method or operation is not implemented.")
     End Sub


     ' Handle the UI exceptions by showing a dialog box, and asking the user whether
     ' or not they wish to abort execution.
     Private Shared Sub Form1_UIThreadException(ByVal sender As Object, ByVal t As ThreadExceptionEventArgs)
         Dim result As System.Windows.Forms.DialogResult = _
             System.Windows.Forms.DialogResult.Cancel
         Try
             result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception)
         Catch
             Try
                 MessageBox.Show("Fatal Windows Forms Error", _
                     "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop)
             Finally
                 Application.Exit()
             End Try
         End Try

         ' Exits the program when the user clicks Abort.
         If result = DialogResult.Abort Then
             Application.Exit()
         End If
     End Sub

     ' Handle the UI exceptions by showing a dialog box, and asking the user whether
     ' or not they wish to abort execution.
     ' NOTE: This exception cannot be kept from terminating the application - it can only 
     ' log the event, and inform the user about it. 
     Private Shared Sub CurrentDomain_UnhandledException(ByVal sender As Object, _
     ByVal e As UnhandledExceptionEventArgs)
         Try
             Dim ex As Exception = CType(e.ExceptionObject, Exception)
             Dim errorMsg As String = "An application error occurred. Please contact the adminstrator " & _
                 "with the following information:" & ControlChars.Lf & ControlChars.Lf

             ' Since we can't prevent the app from terminating, log this to the event log.
             If (Not EventLog.SourceExists("ThreadException")) Then
                 EventLog.CreateEventSource("ThreadException", "Application")
             End If

             ' Create an EventLog instance and assign its source.
             Dim myLog As New EventLog()
             myLog.Source = "ThreadException"
             myLog.WriteEntry((errorMsg + ex.Message & ControlChars.Lf & ControlChars.Lf & _
                 "Stack Trace:" & ControlChars.Lf & ex.StackTrace))
         Catch exc As Exception
             Try
                 MessageBox.Show("Fatal Non-UI Error", "Fatal Non-UI Error. Could not write the error to the event log. " & _
                     "Reason: " & exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop)
             Finally
                 Application.Exit()
             End Try
         End Try
     End Sub


     ' Creates the error message and displays it.
     Private Shared Function ShowThreadExceptionDialog(ByVal title As String, ByVal e As Exception) As DialogResult
         Dim errorMsg As String = "An application error occurred. Please contact the adminstrator " & _
"with the following information:" & ControlChars.Lf & ControlChars.Lf
         errorMsg = errorMsg & e.Message & ControlChars.Lf & _
ControlChars.Lf & "Stack Trace:" & ControlChars.Lf & e.StackTrace

         Return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop)
     End Function

注釈

すべての Windows フォームによってスローされた例外をキャッチするがよくあります。It is often not feasible to catch all of the exceptions thrown by Windows Forms. このメソッドを使用して、Windows フォーム コンポーネントによってスローされたすべての未処理の例外をキャッチして操作を続行するかどうか、または、それらをユーザーに公開して実行を停止するかどうか、アプリケーションに指示できます。Using this method, you can instruct your application whether it should catch all unhandled exceptions thrown by Windows Forms components and continue operating, or whether it should expose them to the user and halt execution.

呼び出すSetUnhandledExceptionModeを使用して、アプリケーションのメイン フォームのインスタンスを作成する前に、Runメソッド。Call SetUnhandledExceptionMode before you instantiate the main form of your application using the Run method.

作成していないスレッドで発生する例外をキャッチし、使用して、Windows フォームによって所有されている、UnhandledExceptionイベント ハンドラー。To catch exceptions that occur in threads not created and owned by Windows Forms, use the UnhandledException event handler.

こちらもご覧ください

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

未処理の例外に応答する方法をアプリケーションに指示し、オプションでスレッド固有の動作を適用します。Instructs the application how to respond to unhandled exceptions, optionally applying thread-specific behavior.

public:
 static void SetUnhandledExceptionMode(System::Windows::Forms::UnhandledExceptionMode mode, bool threadScope);
public static void SetUnhandledExceptionMode (System.Windows.Forms.UnhandledExceptionMode mode, bool threadScope);
static member SetUnhandledExceptionMode : System.Windows.Forms.UnhandledExceptionMode * bool -> unit
Public Shared Sub SetUnhandledExceptionMode (mode As UnhandledExceptionMode, threadScope As Boolean)

パラメーター

mode
UnhandledExceptionMode UnhandledExceptionMode UnhandledExceptionMode UnhandledExceptionMode

キャッチされない例外がスローされた場合に必要なアプリケーションの動作方法を説明する UnhandledExceptionMode 値。An UnhandledExceptionMode value describing how the application should behave if an exception is thrown without being caught.

threadScope
Boolean Boolean Boolean Boolean

スレッド例外モードを設定する場合は true。それ以外の場合は falsetrue to set the thread exception mode; otherwise, false.

例外

アプリケーションが最初のウィンドウを作成した後、例外モードを設定することはできません。You cannot set the exception mode after the application has created its first window.

次のコード例では、Windows フォーム スレッドと他のスレッドで発生する例外の発生する例外のイベント ハンドラーを設定します。The following code example sets event handlers for exceptions that occur on Windows Forms threads and exceptions that occur on other threads. 設定SetUnhandledExceptionModeすべての例外は、アプリケーションのユーザー構成ファイルの設定に関係なく、アプリケーションによって処理されるようにします。It sets SetUnhandledExceptionMode so that all exceptions are handled by the application, regardless of the settings in the application's user configuration file. 使用して、 ThreadException UI スレッドの例外を処理するイベントとUnhandledException非 UI スレッドの例外を処理するイベントです。It uses the ThreadException event to handle UI thread exceptions, and the UnhandledException event to handle non-UI thread exceptions. UnhandledExceptionアプリケーションを防ぐことはできませんの終了、例では、単にエラーがログに終了する前に、アプリケーション イベント ログ。Since UnhandledException cannot prevent an application from terminating, the example simply logs the error in the application event log before termination.

この例では、2 つを定義したButtonコントロール、button1button2Formクラス。This example assumes that you have defined two Button controls, button1 and button2, on your Form class.

   // Creates a class to throw the error.
public:
   ref class ErrorHandler: public System::Windows::Forms::Form
   {
      // Inserts the code to create a form with a button.

      // Programs the button to throw an exception when clicked.
   private:
      void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      {
         throw gcnew ArgumentException( "The parameter was invalid" );
      }

   public:
      static void Main()
      {
         // Creates an instance of the methods that will handle the exception.
         CustomExceptionHandler ^ eh = gcnew CustomExceptionHandler;
         
         // Adds the event handler to the event.
         Application::ThreadException += gcnew ThreadExceptionEventHandler( eh, &Form1::CustomExceptionHandler::OnThreadException );
         
         // Runs the application.
         Application::Run( gcnew ErrorHandler );
      }
   };

   // Creates a class to handle the exception event.
internal:
   ref class CustomExceptionHandler
   {
      // Handles the exception event.
   public:
      void OnThreadException( Object^ /*sender*/, ThreadExceptionEventArgs^ t )
      {
         System::Windows::Forms::DialogResult result = ::DialogResult::Cancel;
         try
         {
            result = this->ShowThreadExceptionDialog( t->Exception );
         }
         catch ( Exception^ ) 
         {
            try
            {
               MessageBox::Show( "Fatal Error", "Fatal Error", MessageBoxButtons::AbortRetryIgnore, MessageBoxIcon::Stop );
            }
            finally
            {
               Application::Exit();
            }
         }
         
         // Exits the program when the user clicks Abort.
         if ( result == ::DialogResult::Abort )
         {
            Application::Exit();
         }
      }

      // Creates the error message and displays it.
   private:
      System::Windows::Forms::DialogResult ShowThreadExceptionDialog( Exception^ e )
      {
         String^ errorMsg = "An error occurred please contact the adminstrator with the following information:\n\n";
         errorMsg = String::Concat( errorMsg, e->Message, "\n\nStack Trace:\n", e->StackTrace );
         return MessageBox::Show( errorMsg, "Application Error", MessageBoxButtons::AbortRetryIgnore, MessageBoxIcon::Stop );
      }
   };
Thread newThread = null;

// Starts the application. 
[SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.ControlAppDomain)]
public static void Main(string[] args)
{
    // Add the event handler for handling UI thread exceptions to the event.
    Application.ThreadException += new ThreadExceptionEventHandler(ErrorHandlerForm.Form1_UIThreadException);

    // Set the unhandled exception mode to force all Windows Forms errors to go through
    // our handler.
    Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);

    // Add the event handler for handling non-UI thread exceptions to the event. 
    AppDomain.CurrentDomain.UnhandledException +=
        new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);

    // Runs the application.
    Application.Run(new ErrorHandlerForm());
}

// Programs the button to throw an exception when clicked.
private void button1_Click(object sender, System.EventArgs e)
{
    throw new ArgumentException("The parameter was invalid");
}

// Start a new thread, separate from Windows Forms, that will throw an exception.
private void button2_Click(object sender, System.EventArgs e)
{
    ThreadStart newThreadStart = new ThreadStart(newThread_Execute);
    newThread = new Thread(newThreadStart);
    newThread.Start();
}

// The thread we start up to demonstrate non-UI exception handling. 
void newThread_Execute()
{
    throw new Exception("The method or operation is not implemented.");
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
private static void Form1_UIThreadException(object sender, ThreadExceptionEventArgs t)
{
    DialogResult result = DialogResult.Cancel;
    try
    {
        result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception);
    }
    catch
    {
        try
        {
            MessageBox.Show("Fatal Windows Forms Error",
                "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }

    // Exits the program when the user clicks Abort.
    if (result == DialogResult.Abort)
        Application.Exit();
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
// NOTE: This exception cannot be kept from terminating the application - it can only 
// log the event, and inform the user about it. 
private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    try
    {
        Exception ex = (Exception)e.ExceptionObject;
        string errorMsg = "An application error occurred. Please contact the adminstrator " +
            "with the following information:\n\n";

        // Since we can't prevent the app from terminating, log this to the event log.
        if (!EventLog.SourceExists("ThreadException"))
        {
            EventLog.CreateEventSource("ThreadException", "Application");
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "ThreadException";
        myLog.WriteEntry(errorMsg + ex.Message + "\n\nStack Trace:\n" + ex.StackTrace);
    }
    catch (Exception exc)
    {
        try
        {
            MessageBox.Show("Fatal Non-UI Error",
                "Fatal Non-UI Error. Could not write the error to the event log. Reason: "
                + exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }
}

// Creates the error message and displays it.
private static DialogResult ShowThreadExceptionDialog(string title, Exception e)
{
    string errorMsg = "An application error occurred. Please contact the adminstrator " +
        "with the following information:\n\n";
    errorMsg = errorMsg + e.Message + "\n\nStack Trace:\n" + e.StackTrace;
    return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore,
        MessageBoxIcon.Stop);
}
     Private newThread As Thread = Nothing

     ' Starts the application. 
     <SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlAppDomain)> _
     Public Shared Sub Main()
         ' Add the event handler for handling UI thread exceptions to the event.
         AddHandler Application.ThreadException, AddressOf ErrorHandlerForm.Form1_UIThreadException

         ' Set the unhandled exception mode to force all Windows Forms errors to go through
         ' our handler.
         Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException)

         ' Add the event handler for handling non-UI thread exceptions to the event. 
         AddHandler AppDomain.CurrentDomain.UnhandledException, AddressOf CurrentDomain_UnhandledException

         ' Runs the application.
         Application.Run(New ErrorHandlerForm())
     End Sub


     ' Programs the button to throw an exception when clicked.
     Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
         Throw New ArgumentException("The parameter was invalid")
     End Sub

     ' Start a new thread, separate from Windows Forms, that will throw an exception.
     Private Sub button2_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button2.Click
         Dim newThreadStart As New ThreadStart(AddressOf newThread_Execute)
         newThread = New Thread(newThreadStart)
         newThread.Start()
     End Sub


     ' The thread we start up to demonstrate non-UI exception handling. 
     Sub newThread_Execute()
         Throw New Exception("The method or operation is not implemented.")
     End Sub


     ' Handle the UI exceptions by showing a dialog box, and asking the user whether
     ' or not they wish to abort execution.
     Private Shared Sub Form1_UIThreadException(ByVal sender As Object, ByVal t As ThreadExceptionEventArgs)
         Dim result As System.Windows.Forms.DialogResult = _
             System.Windows.Forms.DialogResult.Cancel
         Try
             result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception)
         Catch
             Try
                 MessageBox.Show("Fatal Windows Forms Error", _
                     "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop)
             Finally
                 Application.Exit()
             End Try
         End Try

         ' Exits the program when the user clicks Abort.
         If result = DialogResult.Abort Then
             Application.Exit()
         End If
     End Sub

     ' Handle the UI exceptions by showing a dialog box, and asking the user whether
     ' or not they wish to abort execution.
     ' NOTE: This exception cannot be kept from terminating the application - it can only 
     ' log the event, and inform the user about it. 
     Private Shared Sub CurrentDomain_UnhandledException(ByVal sender As Object, _
     ByVal e As UnhandledExceptionEventArgs)
         Try
             Dim ex As Exception = CType(e.ExceptionObject, Exception)
             Dim errorMsg As String = "An application error occurred. Please contact the adminstrator " & _
                 "with the following information:" & ControlChars.Lf & ControlChars.Lf

             ' Since we can't prevent the app from terminating, log this to the event log.
             If (Not EventLog.SourceExists("ThreadException")) Then
                 EventLog.CreateEventSource("ThreadException", "Application")
             End If

             ' Create an EventLog instance and assign its source.
             Dim myLog As New EventLog()
             myLog.Source = "ThreadException"
             myLog.WriteEntry((errorMsg + ex.Message & ControlChars.Lf & ControlChars.Lf & _
                 "Stack Trace:" & ControlChars.Lf & ex.StackTrace))
         Catch exc As Exception
             Try
                 MessageBox.Show("Fatal Non-UI Error", "Fatal Non-UI Error. Could not write the error to the event log. " & _
                     "Reason: " & exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop)
             Finally
                 Application.Exit()
             End Try
         End Try
     End Sub


     ' Creates the error message and displays it.
     Private Shared Function ShowThreadExceptionDialog(ByVal title As String, ByVal e As Exception) As DialogResult
         Dim errorMsg As String = "An application error occurred. Please contact the adminstrator " & _
"with the following information:" & ControlChars.Lf & ControlChars.Lf
         errorMsg = errorMsg & e.Message & ControlChars.Lf & _
ControlChars.Lf & "Stack Trace:" & ControlChars.Lf & e.StackTrace

         Return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop)
     End Function

注釈

すべての Windows フォームによってスローされた例外をキャッチするがよくあります。It is often not feasible to catch all of the exceptions thrown by Windows Forms. このメソッドを使用して、Windows フォーム コンポーネントによってスローされたすべての未処理の例外をキャッチして操作を続行するかどうか、または、それらをユーザーに公開して実行を停止するかどうか、アプリケーションに指示できます。Using this method, you can instruct your application whether it should catch all unhandled exceptions thrown by Windows Forms components and continue operating, or whether it should expose them to the user and halt execution.

呼び出すSetUnhandledExceptionModeを使用して、アプリケーションのメイン フォームのインスタンスを作成する前に、Runメソッド。Call SetUnhandledExceptionMode before you instantiate the main form of your application using the Run method.

ときにthreadScopetrue、スレッド例外モードを設定します。When threadScope is true, the thread exception mode is set. スレッド例外モードが場合、アプリケーション例外モードをオーバーライドmodeに設定されていないAutomaticします。The thread exception mode overrides the application exception mode if mode is not set to Automatic.

ときにthreadScopefalse、アプリケーション例外モードを設定します。When threadScope is false, the application exception mode is set. 含まれるすべてのスレッドのアプリケーション例外モードが使用される、Automaticモード。The application exception mode is used for all threads that have the Automatic mode. アプリケーション例外モードを設定しても、現在のスレッドの設定には影響しません。Setting the application exception mode does not affect the setting of the current thread.

作成していないスレッドで発生する例外をキャッチし、使用して、Windows フォームによって所有されている、UnhandledExceptionイベント ハンドラー。To catch exceptions that occur in threads not created and owned by Windows Forms, use the UnhandledException event handler.

適用対象