Environment.FailFast Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Finaliza inmediatamente el proceso antes de notificar un mensaje de error. Para Windows, el mensaje de error se escribe en el registro de eventos de aplicación de Windows y el mensaje y la información de excepción opcional se incluye en la notificación de errores a Microsoft. En el caso de los sistemas similares a Unix, el mensaje, junto con el seguimiento de la pila, se escribe en el flujo de error estándar.

Sobrecargas

FailFast(String)	Finaliza inmediatamente el proceso antes de notificar un mensaje de error. Para Windows, el mensaje de error se escribe en el registro de eventos de aplicación de Windows y el mensaje se incluye en la notificación de errores a Microsoft. En el caso de los sistemas similares a Unix, el mensaje, junto con el seguimiento de la pila, se escribe en el flujo de error estándar.
FailFast(String, Exception)	Finaliza inmediatamente el proceso antes de notificar un mensaje de error. Para Windows, el mensaje de error se escribe en el registro de eventos de aplicación de Windows y la información de mensaje y excepción se incluye en los informes de errores a Microsoft. En el caso de los sistemas similares a Unix, el mensaje junto con el seguimiento de la pila se escribe en el flujo de error estándar.

FailFast(String)

Source:

Environment.cs

Finaliza inmediatamente el proceso antes de notificar un mensaje de error. Para Windows, el mensaje de error se escribe en el registro de eventos de aplicación de Windows y el mensaje se incluye en la notificación de errores a Microsoft. En el caso de los sistemas similares a Unix, el mensaje, junto con el seguimiento de la pila, se escribe en el flujo de error estándar.

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

Mensaje que explica por qué finalizó el proceso o null si no se proporciona ninguna explicación.

Ejemplos

En el ejemplo siguiente se escribe una entrada de registro en el registro de eventos de aplicación de Windows 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 bloques o finalizadores activos try/finally .

En Windows, el Environment.FailFast método escribe la message cadena en el registro de eventos de aplicación de Windows, crea un volcado de memoria de la aplicación y, a continuación, finaliza el proceso actual. La message cadena también se incluye en los informes de errores a Microsoft a través de Informe de errores de Windows. Para obtener más información, consulte Informe de errores de Windows: 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 método para finalizar la Exit 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 try/finally dañarán los recursos del programa.

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

FailFast(String, Exception)

Source:

Environment.cs

Finaliza inmediatamente el proceso antes de notificar un mensaje de error. Para Windows, el mensaje de error se escribe en el registro de eventos de aplicación de Windows y la información de mensaje y excepción se incluye en los informes de errores a Microsoft. En el caso de los sistemas similares a Unix, el mensaje junto con el seguimiento de la pila se escribe en el flujo de error estándar.

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

Mensaje que explica por qué finalizó el proceso o null si no se proporciona ninguna explicación.

exception

Exception

Una excepción que representa el error que causó la finalización. Esta es normalmente la excepción en un bloque catch.

Comentarios

Este método finaliza el proceso sin ejecutar bloques o finalizadores activos try/finally .

En Windows, el Environment.FailFast método escribe la message cadena en el registro de eventos de aplicación de Windows, crea un volcado de memoria de la aplicación y, a continuación, finaliza el proceso actual.

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

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 inicia, este método funciona igual que la sobrecarga del FailFast(String) método.

Use el Environment.FailFast método en lugar del método para finalizar la Exit 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 try/finally dañarán los recursos del programa.

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