Environment.FailFast Método

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

[System.Security.SecurityCritical]
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

Atributos

SecurityCriticalAttribute

Ejemplos

En el ejemplo siguiente se escribe una entrada de registro en el registro de eventos de Windows Application cuando se ejecuta en Windows, o se escribe el mensaje de error en el flujo de error estándar cuando se ejecuta en un sistema similar a Unix y finaliza el proceso actual.

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.

Comentarios

Este método finaliza un proceso sin ejecutar ningún bloque activo try/finally ni finalizador.

En Windows, el método escribe la cadena /> message también se incluye en los informes de errores para Microsoft a través de Windows Informe de errores. Para obtener más información, vea Windows Informe de errores: Introducción.

En sistemas similares a Unix, el mensaje se escribe en el flujo de error estándar, junto con la información de seguimiento de la pila.

Use el Environment.FailFast método en lugar del Exit método para finalizar la aplicación si el estado de la aplicación está dañado más allá de la reparación y la ejecución de los bloques y finalizadores de la aplicación dañarán los recursos del try/finally programa.

Al llamar al método Environment.FailFast para finalizar la ejecución de una aplicación que se ejecuta en el depurador de Visual Studio, se produce una ExecutionEngineException y se desencadena automáticamente la fatalExecutionEngineError asistente para depuración administrada (MDA).

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);

[<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

Atributos

SecurityCriticalAttribute

Comentarios

Este método finaliza el proceso sin ejecutar ningún bloque activo try/finally ni finalizador.

En Windows, el método escribe la cadena />

La información se notifica a Microsoft mediante Windows informe de errores. Para obtener más información, vea Windows Informe de errores: Introducción. El informe de errores a Microsoft incluye message y exception información, que proporciona detalles usados para clasificar el error. Aunque exception no se controla porque el proceso finaliza, todavía se obtiene la información contextual que generó la excepción.

En sistemas similares a Unix, el mensaje se escribe en el flujo de error estándar, junto con la información de seguimiento de la pila.

Si exception es null, o si exception no se produce, este método funciona igual que la sobrecarga del FailFast(String) método.

Use el Environment.FailFast método en lugar del Exit método para finalizar la aplicación si el estado de la aplicación está dañado más allá de la reparación y la ejecución de los bloques y finalizadores de la aplicación dañarán los recursos del try/finally programa.

Al llamar al método Environment.FailFast para finalizar la ejecución de una aplicación que se ejecuta en el depurador de Visual Studio, se produce una ExecutionEngineException y se desencadena automáticamente la fatalExecutionEngineError asistente para depuración administrada (MDA).