Environment.FailFast Método

Definição

Namespace:

System

Assembly:

System.Runtime.Extensions.dll

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Encerra imediatamente um processo depois de gravar uma mensagem no log de eventos do Aplicativo do Windows e, em seguida, inclui a mensagem e as informações de exceção opcionais no relatório de erros para a Microsoft.

Sobrecargas

FailFast(String)	Um processo é encerrado imediatamente depois de gravar uma mensagem no log de eventos dos aplicativos do Windows e, em seguida, inclui a mensagem no relatório de erros para a Microsoft.
FailFast(String, Exception)	Um processo é encerrado imediatamente depois de gravar uma mensagem no log de eventos do Aplicativo do Windows e, em seguida, inclui a mensagem e as informações de exceção no relatório de erros para a Microsoft.

FailFast(String)

Um processo é encerrado imediatamente depois de gravar uma mensagem no log de eventos dos aplicativos do Windows e, em seguida, inclui a mensagem no relatório de erros para a Microsoft.

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

[System.Security.SecurityCritical]
public static void FailFast (string message);

public static void FailFast (string? message);

public static void FailFast (string message);

[<System.Security.SecurityCritical>]
static member FailFast : string -> unit

static member FailFast : string -> unit

Public Shared Sub FailFast (message As String)

Parâmetros

message

String

Uma mensagem que explica por que o processo foi encerrado ou null se nenhuma explicação for indicada.

Atributos

SecurityCriticalAttribute

Exemplos

O exemplo a seguir grava uma entrada de log no log de eventos do aplicativo Windows e encerra o processo atual.

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.

Comentários

Esse método encerra um processo sem executar blocos ativos try/finally ou finalizadores.

O Environment.FailFast método grava a message cadeia de caracteres no log de eventos do aplicativo Windows, cria um despejo do aplicativo e encerra o processo atual. A message cadeia de caracteres também está incluída no relatório de erros para a Microsoft.

Use o Environment.FailFast método em vez do Exit método para encerrar seu aplicativo se o estado do aplicativo estiver danificado além do reparo, e a execução dos blocos e finalizadores do aplicativo corromperá os recursos do try/finally programa.

As informações são relatadas à Microsoft usando Relatório de Erros do Windows. Para obter mais informações, consulte Relatório de Erros do Windows: Introdução.

Chamar o Environment.FailFast método para encerrar a execução de um aplicativo em execução no Visual Studio depurador gera um ExecutionEngineException e dispara automaticamente o MDA (assistente depuração gerenciada) fatalExecutionEngineError.

FailFast(String, Exception)

Um processo é encerrado imediatamente depois de gravar uma mensagem no log de eventos do Aplicativo do Windows e, em seguida, inclui a mensagem e as informações de exceção no relatório de erros para a Microsoft.

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

[System.Security.SecurityCritical]
public static void FailFast (string message, Exception exception);

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

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

[<System.Security.SecurityCritical>]
static member FailFast : string * Exception -> unit

static member FailFast : string * Exception -> unit

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

Parâmetros

message

String

Uma mensagem que explica por que o processo foi encerrado ou null se nenhuma explicação for indicada.

exception

Exception

Uma exceção que representa o erro que causou o encerramento. Essa geralmente é a exceção em um bloco catch.

Atributos

SecurityCriticalAttribute

Comentários

Esse método encerra o processo sem executar blocos ativos try/finally ou finalizadores.

O Environment.FailFast método grava a message cadeia de caracteres no log de eventos do aplicativo Windows, cria um despejo do aplicativo e encerra o processo atual.

As informações são relatadas à Microsoft usando Relatório de Erros do Windows. Para obter mais informações, consulte Relatório de Erros do Windows: Introdução. O relatório de erros à Microsoft inclui message e exception informações, que fornecem detalhes usados para classificar o erro. Embora não seja exception tratado porque o processo foi encerrado, as informações contextuais que levantaram a exceção ainda são obtidas.

Se exception for null, ou se exception não for lançado, esse método operará o mesmo que a sobrecarga do FailFast(String) método.

Use o Environment.FailFast método em vez do Exit método para encerrar seu aplicativo se o estado do aplicativo estiver danificado além do reparo, e a execução dos blocos e finalizadores do aplicativo corromperá os recursos do try/finally programa.

Chamar o Environment.FailFast método para encerrar a execução de um aplicativo em execução no Visual Studio depurador gera um ExecutionEngineException e dispara automaticamente o MDA (assistente depuração gerenciada) fatalExecutionEngineError.