Environment.FailFast Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

FailFast(String)

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

Environment.CoreCLR.cs

Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows, а сообщение включается в отчет об ошибках Microsoft. Для систем, таких как 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 также включается в отчеты об ошибках Microsoft с помощью отчетов об ошибках Windows. Дополнительные сведения см. в разделе Windows Отчеты об ошибках: начало работы.

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

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

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

FailFast(String, Exception)

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

Environment.CoreCLR.cs

Немедленно завершает процесс перед сообщением об ошибке. Для Windows сообщение об ошибке записывается в журнал событий приложения Windows, а сведения об ошибке и сведения об исключении включены в отчеты об ошибках Microsoft. Для таких систем 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, создает дамп приложения, а затем завершает текущий процесс.

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

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

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

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

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