Environment.FailFast Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Encerra imediatamente o processo antes de relatar uma mensagem de erro. Para o Windows, a mensagem de erro é gravada no log de eventos do Aplicativo windows e as informações de mensagem e exceção opcionais são incluídas no relatório de erros para a Microsoft. Para sistemas semelhantes ao Unix, a mensagem, juntamente com o rastreamento de pilha, é gravada no fluxo de erros padrão.

Sobrecargas

FailFast(String)	Encerra imediatamente o processo antes de relatar uma mensagem de erro. Para o Windows, a mensagem de erro é gravada no log de eventos do Aplicativo windows e a mensagem é incluída no relatório de erros para a Microsoft. Para sistemas semelhantes ao Unix, a mensagem, juntamente com o rastreamento de pilha, é gravada no fluxo de erros padrão.
FailFast(String, Exception)	Encerra imediatamente o processo antes de relatar uma mensagem de erro. Para o Windows, a mensagem de erro é gravada no log de eventos do Aplicativo windows e as informações de mensagem e exceção são incluídas no relatório de erros para a Microsoft. Para sistemas semelhantes ao Unix, a mensagem junto com o rastreamento de pilha é gravada no fluxo de erro padrão.

FailFast(String)

Origem:

Environment.cs

Encerra imediatamente o processo antes de relatar uma mensagem de erro. Para o Windows, a mensagem de erro é gravada no log de eventos do Aplicativo windows e a mensagem é incluída no relatório de erros para a Microsoft. Para sistemas semelhantes ao Unix, a mensagem, juntamente com o rastreamento de pilha, é gravada no fluxo de erros padrão.

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)

Parâmetros

message

String

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

Exemplos

O exemplo a seguir grava uma entrada de log no log de eventos do Aplicativo Windows ao ser executado no Windows ou grava a mensagem de erro no fluxo de erros padrão ao ser executado em um sistema semelhante ao Unix 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.

No Windows, 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 é incluída no relatório de erros para a Microsoft por meio de Relatório de Erros do Windows. Para obter mais informações, consulte Relatório de Erros do Windows: Introdução.

Em sistemas semelhantes ao Unix, a mensagem é gravada no fluxo de erros padrão, juntamente com as informações de rastreamento de pilha.

Use o Environment.FailFast método em vez do método para encerrar seu aplicativo se o estado do aplicativo estiver danificado além do reparo e a execução dos Exit 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 depurador do Visual Studio gera um ExecutionEngineException e dispara automaticamente o fatalExecutionEngineError managed debugging assistente (MDA).

FailFast(String, Exception)

Origem:

Environment.cs

Encerra imediatamente o processo antes de relatar uma mensagem de erro. Para o Windows, a mensagem de erro é gravada no log de eventos do Aplicativo windows e as informações de mensagem e exceção são incluídas no relatório de erros para a Microsoft. Para sistemas semelhantes ao Unix, a mensagem junto com o rastreamento de pilha é gravada no fluxo de erro padrão.

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)

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.

Comentários

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

No Windows, 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 para a Microsoft inclui message informações e exception , que fornecem detalhes usados para classificar o erro. Embora exception não seja tratado porque o processo foi encerrado, as informações contextuais que geraram a exceção ainda são obtidas.

Em sistemas semelhantes ao Unix, a mensagem é gravada no fluxo de erros padrão, juntamente com as informações de rastreamento de pilha.

Se exception for nullou se exception não for gerado, esse método funcionará da mesma forma que a sobrecarga do FailFast(String) método.

Use o Environment.FailFast método em vez do método para encerrar seu aplicativo se o estado do aplicativo estiver danificado além do reparo e a execução dos Exit 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 depurador do Visual Studio gera um ExecutionEngineException e dispara automaticamente o fatalExecutionEngineError managed debugging assistente (MDA).