Environment.FailFast メソッド

定義

メッセージを Windows アプリケーションのイベント ログに書き込んだ直後にプロセスを終了させ、Microsoft に送信するエラー レポートにそのメッセージとオプションの例外情報を含めます。Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and optional exception information in error reporting to Microsoft.

オーバーロード

FailFast(String)

メッセージを Windows アプリケーションのイベント ログに書き込んだ直後にプロセスを終了させ、Microsoft に送信するエラー レポートにそのメッセージを含めます。Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message in error reporting to Microsoft.

FailFast(String, Exception)

メッセージを Windows アプリケーションのイベント ログに書き込んだ直後にプロセスを終了させ、Microsoft に送信するエラー レポートにそのメッセージと例外情報を含めます。Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and exception information in error reporting to Microsoft.

FailFast(String)

メッセージを Windows アプリケーションのイベント ログに書き込んだ直後にプロセスを終了させ、Microsoft に送信するエラー レポートにそのメッセージを含めます。Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message in error reporting to Microsoft.

public:
 static void FailFast(System::String ^ message);
[System.Security.SecurityCritical]
public static void FailFast (string message);
static member FailFast : string -> unit
Public Shared Sub FailFast (message As String)

パラメーター

message
String

プロセスが終了させられた原因を説明するメッセージ。説明を提供しない場合は nullA message that explains why the process was terminated, or null if no explanation is provided.

属性

次の例では、Windows アプリケーションイベントログにログエントリを書き込み、現在のプロセスを終了します。The following example writes a log entry to the Windows Application event log and terminates the current process.

using System;

class Example
{
    public static void Main() 
    {
       string causeOfFailure = "A catastrophic failure has occurred.";

       // Assume your application has failed catastrophically and must
       // terminate immediately. The try-finally block is not executed
       // and is included only to demonstrate that instructions within
       // try-catch blocks and finalizers are not performed.
       try 
       {
           Environment.FailFast(causeOfFailure);
       }
       finally 
       {
           Console.WriteLine("This finally block will not be executed.");
       }
   }
}
/*
The example produces no output because the application is terminated.
However, an entry is made in the Windows Application event log, and
the log entry contains the text from the causeOfFailure variable.
*/
Module Example
    Public Sub Main()
        Dim causeOfFailure As String = "A catastrophic failure has occurred."
        ' Assume your application has failed catastrophically and must
        ' terminate immediately. The try-finally block is not executed 
        ' and is included only to demonstrate that instructions within 
        ' try-catch blocks and finalizers are not performed.

        Try
            Environment.FailFast(causeOfFailure)
        Finally
            Console.WriteLine("This finally block will not be executed.")
        End Try
    End Sub
End Module
'
' The code example displays no output because the application is
' terminated. However, an entry is made in the Windows Application event
' log, and the log entry contains the text from the causeOfFailure variable.

注釈

このメソッドは、アクティブな try @ no__t @ no__t ブロックまたはファイナライザーを実行せずにプロセスを終了します。This method terminates a process without running any active try/finally blocks or finalizers.

@No__t-0 メソッドは、Windows アプリケーションイベントログに message 文字列を書き込み、アプリケーションのダンプを作成して、現在のプロセスを終了します。The Environment.FailFast method writes the message string to the Windows Application event log, creates a dump of your application, and then terminates the current process. @No__t 0 の文字列も、Microsoft へのエラー報告に含まれています。The message string is also included in error reporting to Microsoft.

アプリケーションの状態が repair を超えて破損した場合にアプリケーションを終了するには、Exit メソッドの代わりに Environment.FailFast メソッドを使用し、アプリケーションの try @ no__t @ no__t ブロックとファイナライザーはプログラムリソースを破損します。Use the Environment.FailFast method instead of the Exit method to terminate your application if the state of your application is damaged beyond repair, and executing your application's try/finally blocks and finalizers will corrupt program resources.

情報は、Windows エラー報告を使用して Microsoft に報告されます。Information is reported to Microsoft by using Windows Error Reporting. 詳細については、「[Windows エラー報告」を参照してください。はじめに @ no__t-0 です。For more information, see Windows Error Reporting: Getting Started.

Visual Studio デバッガーで実行されているアプリケーションの実行を終了するために Environment.FailFast メソッドを呼び出すと、ExecutionEngineException がスローされ、 fatalExecutionEngineError マネージデバッグアシスタント (MDA)が自動的にトリガーされます。Calling the Environment.FailFast method to terminate execution of an application running in the Visual Studio debugger throws an ExecutionEngineException and automatically triggers the fatalExecutionEngineError managed debugging assistant (MDA).

セキュリティ

SecurityCriticalAttribute
直前の呼び出し元に完全信頼が必要です。requires full trust for the immediate caller. このメンバーは、部分的に信頼されているコードまたは透過的なコードでは使用できません。This member cannot be used by partially trusted or transparent code.

FailFast(String, Exception)

メッセージを Windows アプリケーションのイベント ログに書き込んだ直後にプロセスを終了させ、Microsoft に送信するエラー レポートにそのメッセージと例外情報を含めます。Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and exception information in error reporting to Microsoft.

public:
 static void FailFast(System::String ^ message, Exception ^ exception);
[System.Security.SecurityCritical]
public static void FailFast (string message, Exception exception);
static member FailFast : string * Exception -> unit

パラメーター

message
String

プロセスが終了させられた原因を説明するメッセージ。説明を提供しない場合は nullA message that explains why the process was terminated, or null if no explanation is provided.

exception
Exception

終了の原因となったエラーを表す例外。An exception that represents the error that caused the termination. 通常、これは catch ブロックでの例外です。This is typically the exception in a catch block.

属性

注釈

このメソッドは、アクティブな try @ no__t @ no__t ブロックまたはファイナライザーを実行せずにプロセスを終了します。This method terminates the process without running any active try/finally blocks or finalizers.

@No__t-0 メソッドは、Windows アプリケーションイベントログに message 文字列を書き込み、アプリケーションのダンプを作成して、現在のプロセスを終了します。The Environment.FailFast method writes the message string to the Windows Application event log, creates a dump of your application, and then terminates the current process.

情報は、Windows エラー報告を使用して Microsoft に報告されます。Information is reported to Microsoft by using Windows Error Reporting. 詳細については、「[Windows エラー報告」を参照してください。はじめに @ no__t-0 です。For more information, see Windows Error Reporting: Getting Started. Microsoft へのエラー報告には messageexception の情報が含まれています。この情報は、エラーの分類に使用される詳細情報を提供します。Error reporting to Microsoft includes message and exception information, which provides details used to classify the error. プロセスが終了したため、exception は処理されませんが、例外を発生させたコンテキスト情報は引き続き取得されます。Although exception is not handled because the process is terminated, the contextual information that raised the exception is still obtained.

@No__t-0 @no__t が-1 の場合、または exception がスローされなかった場合、このメソッドは FailFast(String) メソッドオーバーロードと同じように動作します。If exception is null, or if exception is not thrown, this method operates the same as the FailFast(String) method overload.

アプリケーションの状態が repair を超えて破損した場合にアプリケーションを終了するには、Exit メソッドの代わりに Environment.FailFast メソッドを使用し、アプリケーションの try @ no__t @ no__t ブロックとファイナライザーはプログラムリソースを破損します。Use the Environment.FailFast method instead of the Exit method to terminate your application if the state of your application is damaged beyond repair, and executing your application's try/finally blocks and finalizers will corrupt program resources.

Visual Studio デバッガーで実行されているアプリケーションの実行を終了するために Environment.FailFast メソッドを呼び出すと、ExecutionEngineException がスローされ、 fatalExecutionEngineError マネージデバッグアシスタント (MDA)が自動的にトリガーされます。Calling the Environment.FailFast method to terminate execution of an application running in the Visual Studio debugger throws an ExecutionEngineException and automatically triggers the fatalExecutionEngineError managed debugging assistant (MDA).

セキュリティ

SecurityCriticalAttribute
直前の呼び出し元に完全信頼が必要です。requires full trust for the immediate caller. このメンバーは、部分的に信頼されているコードまたは透過的なコードでは使用できません。This member cannot be used by partially trusted or transparent code.

適用対象