Environment.FailFast Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Beendet den Prozess sofort, bevor eine Fehlermeldung gemeldet wird. Für Windows wird die Fehlermeldung in das Windows-Anwendungsereignisprotokoll geschrieben, und die Meldung und optionalen Ausnahmeinformationen sind in der Fehlerberichterstattung an Microsoft enthalten. Bei Unix-ähnlichen Systemen wird die Nachricht neben der Stapelablaufverfolgung in den Standardfehlerstream geschrieben.

Überlädt

FailFast(String)	Beendet den Prozess sofort, bevor eine Fehlermeldung gemeldet wird. Für Windows wird die Fehlermeldung in das Windows-Anwendungsereignisprotokoll geschrieben, und die Meldung ist in der Fehlerberichterstattung an Microsoft enthalten. Bei Unix-ähnlichen Systemen wird die Nachricht neben der Stapelablaufverfolgung in den Standardfehlerstream geschrieben.
FailFast(String, Exception)	Beendet den Prozess sofort, bevor eine Fehlermeldung gemeldet wird. Für Windows wird die Fehlermeldung in das Windows-Anwendungsereignisprotokoll geschrieben, und die Meldung und Ausnahmeinformationen sind in der Fehlerberichterstattung an Microsoft enthalten. Bei Unix-ähnlichen Systemen wird die Nachricht neben der Stapelablaufverfolgung in den Standardfehlerstream geschrieben.

FailFast(String)

Quelle:

Environment.cs

Beendet den Prozess sofort, bevor eine Fehlermeldung gemeldet wird. Für Windows wird die Fehlermeldung in das Windows-Anwendungsereignisprotokoll geschrieben, und die Meldung ist in der Fehlerberichterstattung an Microsoft enthalten. Bei Unix-ähnlichen Systemen wird die Nachricht neben der Stapelablaufverfolgung in den Standardfehlerstream geschrieben.

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)

Parameter

message

String

Eine Meldung, die erklärt, warum der Prozess beendet wurde, oder null, wenn keine Erklärung gegeben wird.

Beispiele

Das folgende Beispiel schreibt einen Protokolleintrag in das Windows-Anwendungsereignisprotokoll, wenn unter Windows ausgeführt wird, oder schreibt die Fehlermeldung in den Standardfehlerstream, wenn unter einem Unix-ähnlichen System ausgeführt wird, und beendet den aktuellen Prozess.

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.

Hinweise

Diese Methode beendet einen Prozess, ohne aktive try/finally Blöcke oder Finalizer auszuführen.

Unter Windows schreibt die Environment.FailFast -Methode die message Zeichenfolge in das Windows-Anwendungsereignisprotokoll, erstellt ein Dump Ihrer Anwendung und beendet dann den aktuellen Prozess. Die message Zeichenfolge ist auch in der Fehlerberichterstattung an Microsoft über Windows-Fehlerberichterstattung enthalten. Weitere Informationen finden Sie unter Windows-Fehlerberichterstattung: Erste Schritte.

Auf Unix-ähnlichen Systemen wird die Nachricht zusammen mit den Stapelablaufverfolgungsinformationen in den Standardfehlerstream geschrieben.

Verwenden Sie die Environment.FailFast -Methode anstelle der Exit -Methode, um Ihre Anwendung zu beenden, wenn der Zustand Ihrer Anwendung ohne Reparatur beschädigt ist, und das Ausführen der Blöcke und Finalisierer Ihrer Anwendung try/finally die Programmressourcen beschädigt.

Das Aufrufen der Environment.FailFast Methode zum Beenden der Ausführung einer Anwendung, die im Visual Studio-Debugger ausgeführt wird, löst einen ExecutionEngineException aus und löst automatisch das verwaltete Debuggen von fatalExecutionEngineError Assistent (MDA) aus.

FailFast(String, Exception)

Quelle:

Environment.cs

Beendet den Prozess sofort, bevor eine Fehlermeldung gemeldet wird. Für Windows wird die Fehlermeldung in das Windows-Anwendungsereignisprotokoll geschrieben, und die Meldung und Ausnahmeinformationen sind in der Fehlerberichterstattung an Microsoft enthalten. Bei Unix-ähnlichen Systemen wird die Nachricht neben der Stapelablaufverfolgung in den Standardfehlerstream geschrieben.

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)

Parameter

message

String

Eine Meldung, die erklärt, warum der Prozess beendet wurde, oder null, wenn keine Erklärung gegeben wird.

exception

Exception

Eine Ausnahme, die den Fehler darstellt, der die Beendigung verursacht hat. Dies ist in der Regel die Ausnahme in einem catch-Block.

Hinweise

Mit dieser Methode wird der Prozess beendet, ohne dass aktive try/finally Blöcke oder Finalisierer ausgeführt werden.

Unter Windows schreibt die Environment.FailFast -Methode die message Zeichenfolge in das Windows-Anwendungsereignisprotokoll, erstellt ein Dump Ihrer Anwendung und beendet dann den aktuellen Prozess.

Informationen werden mithilfe von Windows-Fehlerberichterstattung an Microsoft gemeldet. Weitere Informationen finden Sie unter Windows-Fehlerberichterstattung: Erste Schritte. Die Fehlerberichterstattung an Microsoft enthält message informationen und exception enthält Details, die zur Klassifizierung des Fehlers verwendet werden. Obwohl exception nicht behandelt wird, weil der Prozess beendet wird, werden die Kontextinformationen, die die Ausnahme ausgelöst haben, trotzdem abgerufen.

Auf Unix-ähnlichen Systemen wird die Nachricht zusammen mit den Stapelablaufverfolgungsinformationen in den Standardfehlerstream geschrieben.

nullWenn exception ist oder nicht exception ausgelöst wird, funktioniert diese Methode mit der FailFast(String) Methodenüberladung.

Verwenden Sie die Environment.FailFast -Methode anstelle der Exit -Methode, um Ihre Anwendung zu beenden, wenn der Zustand Ihrer Anwendung ohne Reparatur beschädigt ist, und das Ausführen der Blöcke und Finalisierer Ihrer Anwendung try/finally die Programmressourcen beschädigt.

Das Aufrufen der Environment.FailFast Methode zum Beenden der Ausführung einer Anwendung, die im Visual Studio-Debugger ausgeführt wird, löst einen ExecutionEngineException aus und löst automatisch das verwaltete Debuggen von fatalExecutionEngineError Assistent (MDA) aus.