Environment.FailFast Método

Definição

Espaço de Nomes:

System

Assemblagem:

mscorlib.dll

Termina imediatamente o processo antes de reportar uma mensagem de erro. Para o Windows, a mensagem de erro é escrita no registo de eventos da Aplicação Windows, e a informação da mensagem e das exceções opcionais está incluída no relatório de erros à Microsoft. Para sistemas do tipo Unix, a mensagem, juntamente com o traço de pilha, é escrita no fluxo de erro padrão.

Sobrecargas

Name	Description
FailFast(String)	Termina imediatamente o processo antes de reportar uma mensagem de erro. Para o Windows, a mensagem de erro é escrita no registo de eventos da Aplicação Windows, e a mensagem é incluída no relatório de erros à Microsoft. Para sistemas do tipo Unix, a mensagem, juntamente com o traço de pilha, é escrita no fluxo de erro padrão.
FailFast(String, Exception)	Termina imediatamente o processo antes de reportar uma mensagem de erro. Para o Windows, a mensagem de erro é escrita no registo de eventos da Aplicação Windows, e a informação da mensagem e exceção é incluída no relatório de erros à Microsoft. Para sistemas do tipo Unix, a mensagem juntamente com o rastreio de pilha é escrita no fluxo de erro padrão.

FailFast(String)

Termina imediatamente o processo antes de reportar uma mensagem de erro. Para o Windows, a mensagem de erro é escrita no registo de eventos da Aplicação Windows, e a mensagem é incluída no relatório de erros à Microsoft. Para sistemas do tipo Unix, a mensagem, juntamente com o traço de pilha, é escrita no fluxo de erro padrão.

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

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

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

Public Shared Sub FailFast (message As String)

Parâmetros

message

String

Uma mensagem que explica porque é que o processo foi terminado, ou null se não for fornecida explicação.

Atributos

SecurityCriticalAttribute

Exemplos

O exemplo seguinte escreve uma entrada de registo no registo de eventos de aplicações do Windows quando está a correr no Windows, ou escreve a mensagem de erro no fluxo de erro padrão ao correr num sistema do tipo Unix, terminando 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.

Observações

Este método termina um processo sem executar blocos ativos try/finally ou finalizadores.

No Windows, o método Environment.FailFast escreve a cadeia message no registo de eventos da aplicação Windows, cria um dump da sua aplicação e termina o processo atual. A cadeia message também é incluída no relatório de erros a Microsoft via Windows Relatório de Erros. Para mais informações, consulte Windows Relatório de Erros: Começar.

Em sistemas do tipo Unix, a mensagem é escrita no fluxo de erro padrão, juntamente com a informação do traço da pilha.

Use o Environment.FailFast método em vez do Exit método para terminar a sua aplicação se o estado da sua aplicação estiver danificado para além da reparação, e executar os blocos e finalizadores da try/finally sua aplicação corromperá os recursos do programa.

Chamar o método Environment.FailFast para terminar a execução de uma aplicação a correr no depurador de Visual Studio lança um ExecutionEngineException e dispara automaticamente o assistente de depuração gerido fatalExecutionEngineError (MDA).

FailFast(String, Exception)

Termina imediatamente o processo antes de reportar uma mensagem de erro. Para o Windows, a mensagem de erro é escrita no registo de eventos da Aplicação Windows, e a informação da mensagem e exceção é incluída no relatório de erros à Microsoft. Para sistemas do tipo Unix, a mensagem juntamente com o rastreio de pilha é escrita no fluxo de erro padrão.

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

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

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

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

Parâmetros

message

String

Uma mensagem que explica porque é que o processo foi terminado, ou null se não for fornecida explicação.

exception

Exception

Uma exceção que representa o erro que causou a terminação. Esta é tipicamente a exceção num catch bloco.

Atributos

SecurityCriticalAttribute

Observações

Este método termina o processo sem executar blocos ativos try/finally ou finalizadores.

No Windows, o método Environment.FailFast escreve a cadeia message no registo de eventos da aplicação Windows, cria um dump da sua aplicação e termina o processo atual.

A informação é reportada à Microsoft através do Windows Error Reporting. Para mais informações, consulte Windows Relatório de Erros: Começar. O relatório de erros à Microsoft inclui informações message e exception, que fornecem detalhes usados para classificar o erro. Embora exception não seja tratado porque o processo é terminado, a informação contextual que levantou a exceção é ainda assim obtida.

Em sistemas do tipo Unix, a mensagem é escrita no fluxo de erro padrão, juntamente com a informação do traço da pilha.

Se exception for null, ou se exception não for lançado, este método funciona da mesma forma que a FailFast(String) sobrecarga do método.

Use o Environment.FailFast método em vez do Exit método para terminar a sua aplicação se o estado da sua aplicação estiver danificado para além da reparação, e executar os blocos e finalizadores da try/finally sua aplicação corromperá os recursos do programa.

Chamar o método Environment.FailFast para terminar a execução de uma aplicação a correr no depurador de Visual Studio lança um ExecutionEngineException e dispara automaticamente o assistente de depuração gerido fatalExecutionEngineError (MDA).