Environment.FailFast Environment.FailFast Environment.FailFast Environment.FailFast Method

Definition

Beendet einen Prozess sofort, nachdem eine Meldung in das Windows-Anwendungsereignisprotokoll geschrieben wurde, und schließt dann die Meldung und optionale Ausnahmeinformationen in Fehlerberichte an Microsoft ein.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and optional exception information in error reporting to Microsoft.

Überlädt

FailFast(String) FailFast(String) FailFast(String) FailFast(String)

Beendet einen Prozess sofort, nachdem eine Meldung in das Windows-Anwendungsereignisprotokoll geschrieben wurde, und schließt dann die Meldung in Fehlerberichte an Microsoft ein.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message in error reporting to Microsoft.

FailFast(String, Exception) FailFast(String, Exception) FailFast(String, Exception)

Beendet einen Prozess sofort, nachdem eine Meldung in das Windows-Anwendungsereignisprotokoll geschrieben wurde, und schließt dann die Meldung und Ausnahmeinformationen in Fehlerberichte an Microsoft ein.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and exception information in error reporting to Microsoft.

FailFast(String) FailFast(String) FailFast(String) FailFast(String)

Beendet einen Prozess sofort, nachdem eine Meldung in das Windows-Anwendungsereignisprotokoll geschrieben wurde, und schließt dann die Meldung in Fehlerberichte an Microsoft ein.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message in error reporting to Microsoft.

public:
 static void FailFast(System::String ^ message);
[System.Security.SecurityCritical]
public static void FailFast (string message);
static member FailFast : string -> unit
Public Shared Sub FailFast (message As String)

Parameter

message
String String String String

Eine Meldung, die erklärt, warum der Prozess beendet wurde, oder null, wenn keine Erklärung gegeben wird.A message that explains why the process was terminated, or null if no explanation is provided.

Beispiele

Im folgenden Beispiel wird ein Protokolleintrag in das Windows-Anwendungs Ereignisprotokoll geschrieben, und der aktuelle Prozess wird beendet.The following example writes a log entry to the Windows Application event log and terminates the current process.

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.
*/
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

Mit dieser Methode wird ein Prozess beendet, ohne try dass aktive / finally Blöcke oder Finalizer ausgeführt werden.This method terminates a process without running any active try/finally blocks or finalizers.

Die Environment.FailFast -Methode schreibt message die Zeichenfolge in das Windows-Anwendungs Ereignisprotokoll, erstellt einen Dump der Anwendung und beendet dann den aktuellen Prozess.The Environment.FailFast method writes the message string to the Windows Application event log, creates a dump of your application, and then terminates the current process. Die message Zeichenfolge ist auch bei der Fehlerberichterstattung an Microsoft enthalten.The message string is also included in error reporting to Microsoft.

Verwenden Sie Environment.FailFast die- try Exit Methodeanstellefinally der-Methode, um die Anwendung zu beenden, wenn der Status der Anwendung über die Reparatur hinaus beschädigt ist, und führen Sie die Blöcke und Finalizer der Anwendung aus. / Programmressourcen werden beschädigt.Use the Environment.FailFast method instead of the Exit method to terminate your application if the state of your application is damaged beyond repair, and executing your application's try/finally blocks and finalizers will corrupt program resources.

Informationen werden an Microsoft über Windows-Fehlerberichterstattung gemeldet.Information is reported to Microsoft by using Windows Error Reporting. Weitere Informationen finden Sie unter Windows-Fehlerberichterstattung: Einstieg.For more information, see Windows Error Reporting: Getting Started.

Wenn Sie Environment.FailFast die-Methode aufrufen, um die Ausführung einer Anwendung zu beenden, die im Visual ExecutionEngineException Studio-Debugger ausgeführt wird, wird eine ausgelöst, und der fatalExecutionEngineError-MDA (Assistent für verwaltetes Debugging)Calling the Environment.FailFast method to terminate execution of an application running in the Visual Studio debugger throws an ExecutionEngineException and automatically triggers the fatalExecutionEngineError managed debugging assistant (MDA).

Sicherheit

SecurityCriticalAttribute
erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.requires full trust for the immediate caller. Dieser Member kann nicht von teilweise vertrauenswürdigem oder transparentem Code verwendet werden.This member cannot be used by partially trusted or transparent code.

FailFast(String, Exception) FailFast(String, Exception) FailFast(String, Exception)

Beendet einen Prozess sofort, nachdem eine Meldung in das Windows-Anwendungsereignisprotokoll geschrieben wurde, und schließt dann die Meldung und Ausnahmeinformationen in Fehlerberichte an Microsoft ein.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and exception information in error reporting to Microsoft.

public:
 static void FailFast(System::String ^ message, Exception ^ exception);
[System.Security.SecurityCritical]
public static void FailFast (string message, Exception exception);
static member FailFast : string * Exception -> unit

Parameter

message
String String String String

Eine Meldung, die erklärt, warum der Prozess beendet wurde, oder null, wenn keine Erklärung gegeben wird.A message that explains why the process was terminated, or null if no explanation is provided.

exception
Exception Exception Exception Exception

Eine Ausnahme, die den Fehler darstellt, der die Beendigung verursacht hat.An exception that represents the error that caused the termination. Dies ist in der Regel die Ausnahme in einem catch-Block.This is typically the exception in a catch block.

Hinweise

Diese Methode beendet den Prozess, ohne dass aktive try / finally Blöcke oder Finalizer ausgeführt werden.This method terminates the process without running any active try/finally blocks or finalizers.

Die Environment.FailFast -Methode schreibt message die Zeichenfolge in das Windows-Anwendungs Ereignisprotokoll, erstellt einen Dump der Anwendung und beendet dann den aktuellen Prozess.The Environment.FailFast method writes the message string to the Windows Application event log, creates a dump of your application, and then terminates the current process.

Informationen werden an Microsoft über Windows-Fehlerberichterstattung gemeldet.Information is reported to Microsoft by using Windows Error Reporting. Weitere Informationen finden Sie unter Windows-Fehlerberichterstattung: Einstieg.For more information, see Windows Error Reporting: Getting Started. Bei der Fehlerberichterstattung an message Microsoft exception sind die Informationen und enthalten, die Details zum Klassifizieren des Fehlers enthalten.Error reporting to Microsoft includes message and exception information, which provides details used to classify the error. Obwohl exception nicht behandelt wird, da der Prozess beendet wird, werden die Kontextinformationen, die die Ausnahme ausgelöst haben, weiterhin abgerufen.Although exception is not handled because the process is terminated, the contextual information that raised the exception is still obtained.

Wenn exception ist nulloder FailFast(String) Wenn exception nicht ausgelöst wird, funktioniert diese Methode genauso wie die-Methoden Überladung.If exception is null, or if exception is not thrown, this method operates the same as the FailFast(String) method overload.

Verwenden Sie Environment.FailFast die- try Exit Methodeanstellefinally der-Methode, um die Anwendung zu beenden, wenn der Status der Anwendung über die Reparatur hinaus beschädigt ist, und führen Sie die Blöcke und Finalizer der Anwendung aus. / Programmressourcen werden beschädigt.Use the Environment.FailFast method instead of the Exit method to terminate your application if the state of your application is damaged beyond repair, and executing your application's try/finally blocks and finalizers will corrupt program resources.

Wenn Sie Environment.FailFast die-Methode aufrufen, um die Ausführung einer Anwendung zu beenden, die im Visual ExecutionEngineException Studio-Debugger ausgeführt wird, wird eine ausgelöst, und der fatalExecutionEngineError-MDA (Assistent für verwaltetes Debugging)Calling the Environment.FailFast method to terminate execution of an application running in the Visual Studio debugger throws an ExecutionEngineException and automatically triggers the fatalExecutionEngineError managed debugging assistant (MDA).

Sicherheit

SecurityCriticalAttribute
erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.requires full trust for the immediate caller. Dieser Member kann nicht von teilweise vertrauenswürdigem oder transparentem Code verwendet werden.This member cannot be used by partially trusted or transparent code.

Gilt für: