Environment.FailFast Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows, а сообщение и необязательные сведения об исключении включаются в отчеты об ошибках в Корпорацию Майкрософт. Для unix-подобных систем сообщение вместе с трассировкой стека записывается в стандартный поток ошибок.

Перегрузки

FailFast(String)	Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows и включается в отчеты об ошибках в корпорацию Майкрософт. Для unix-подобных систем сообщение вместе с трассировкой стека записывается в стандартный поток ошибок.
FailFast(String, Exception)	Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows, а сообщение и сведения об исключении включаются в отчеты об ошибках в Корпорацию Майкрософт. Для unix-подобных систем сообщение вместе с трассировкой стека записывается в стандартный поток ошибок.

FailFast(String)

Исходный код:

Environment.cs

Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows и включается в отчеты об ошибках в корпорацию Майкрософт. Для unix-подобных систем сообщение вместе с трассировкой стека записывается в стандартный поток ошибок.

public:
 static void FailFast(System::String ^ message);

public static void FailFast (string? message);

static member FailFast : string -> unit

Public Shared Sub FailFast (message As String)

Параметры

message

String

Сообщение, в котором объясняется причина завершения процесса или содержится значение null, если объяснение отсутствует.

Примеры

В следующем примере запись журнала записывается в журнал событий приложений Windows при запуске в Windows или сообщение об ошибке в стандартный поток ошибок при выполнении в системе, подобной Unix, и завершает текущий процесс.

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.
*/

open System

let 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
    printfn "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/finally блоков или методов завершения.

В Windows Environment.FailFast метод записывает строку в message журнал событий приложения Windows, создает дамп приложения, а затем завершает текущий процесс. Эта message строка также включается в отчет об ошибках в корпорацию Майкрософт через отчеты об ошибках Windows. Дополнительные сведения см. в разделе отчеты об ошибках Windows: начало работы.

В unix-подобных системах сообщение записывается в стандартный поток ошибок вместе со сведениями трассировки стека.

Environment.FailFast Используйте метод вместо Exit метода , чтобы завершить работу приложения, если состояние приложения повреждено после восстановления, а выполнение блоков и методов завершения приложения try/finally повреждает ресурсы программы.

Environment.FailFast Вызов метода для завершения выполнения приложения, запущенного в отладчике Visual Studio, вызывает исключение и автоматически активирует управляемую отладку fatalExecutionEngineError помощник (MDAExecutionEngineException).

FailFast(String, Exception)

Исходный код:

Environment.cs

Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows, а сообщение и сведения об исключении включаются в отчеты об ошибках в Корпорацию Майкрософт. Для unix-подобных систем сообщение вместе с трассировкой стека записывается в стандартный поток ошибок.

public:
 static void FailFast(System::String ^ message, Exception ^ exception);

public static void FailFast (string? message, Exception? exception);

static member FailFast : string * Exception -> unit

Public Shared Sub FailFast (message As String, exception As Exception)

Параметры

message

String

Сообщение, в котором объясняется причина завершения процесса или содержится значение null, если объяснение отсутствует.

exception

Exception

Исключение, представляющее ошибку, вызвавшую завершение процесса. Обычно это исключение в блоке catch.

Комментарии

Этот метод завершает процесс без запуска активных try/finally блоков или методов завершения.

В Windows Environment.FailFast метод записывает строку в message журнал событий приложения Windows, создает дамп приложения, а затем завершает текущий процесс.

Сведения передаются в корпорацию Майкрософт с помощью отчеты об ошибках Windows. Дополнительные сведения см. в разделе отчеты об ошибках Windows: начало работы. Отчеты об ошибках в Корпорацию Майкрософт включают messageexception и сведения, которые предоставляют сведения, используемые для классификации ошибки. Хотя exception не обрабатывается, так как процесс завершается, контекстная информация, создающая исключение, по-прежнему получается.

В unix-подобных системах сообщение записывается в стандартный поток ошибок вместе со сведениями трассировки стека.

Если exception имеет значение null, или если exception не вызывается, этот метод работает так же, как и перегрузка FailFast(String) метода.

Environment.FailFast Используйте метод вместо Exit метода , чтобы завершить работу приложения, если состояние приложения повреждено после восстановления, а выполнение блоков и методов завершения приложения try/finally повреждает ресурсы программы.

Environment.FailFast Вызов метода для завершения выполнения приложения, запущенного в отладчике Visual Studio, вызывает исключение и автоматически активирует управляемую отладку fatalExecutionEngineError помощник (MDAExecutionEngineException).