Environment.FailFast Methode

Bron:

Environment.CoreCLR.cs

Bron:

Environment.CoreCLR.cs

Bron:

Environment.cs

Bron:

Environment.cs

Bron:

Environment.CoreCLR.cs

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

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

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)

Parameters

Kenmerken

SecurityCriticalAttribute

Voorbeelden

In het volgende voorbeeld wordt een logboekvermelding naar het gebeurtenislogboek van de Windows toepassing geschreven wanneer het onder Windows wordt uitgevoerd of wordt het foutbericht naar de standaardfoutstroom geschreven bij uitvoering onder een Unix-achtig systeem en wordt het huidige proces beëindigd.

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.

Opmerkingen

Met deze methode wordt een proces beëindigd zonder actieve try/finally blokken of finalizers uit te voeren.

In Windows schrijft de methode Environment.FailFast de tekenreeks message naar het gebeurtenislogboek van de Windows toepassing, maakt u een dump van uw toepassing en beëindigt u het huidige proces. De tekenreeks message wordt ook opgenomen in foutrapportage voor Microsoft via Windows Foutrapportage. Zie Windows Foutrapportage: Aan de slag voor meer informatie.

Op Unix-achtige systemen wordt het bericht samen met de stacktraceringsinformatie naar de standaardfoutstroom geschreven.

Gebruik de Environment.FailFast methode in plaats van de Exit methode om uw toepassing te beëindigen als de status van uw toepassing niet meer kan worden hersteld en als u de blokken en finalizers van uw toepassing try/finally uitvoert, worden programmaresources beschadigd.

Als u de methode Environment.FailFast aanroept om de uitvoering van een toepassing die wordt uitgevoerd in het Visual Studio foutopsporingsprogramma, wordt een ExecutionEngineException gegenereerd en wordt de fatalExecutionEngineError Managed Debugging Assistant (MDA) geactiveerd.

Bron:

Environment.CoreCLR.cs

Bron:

Environment.CoreCLR.cs

Bron:

Environment.cs

Bron:

Environment.cs

Bron:

Environment.CoreCLR.cs

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

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)

Parameters

Kenmerken

SecurityCriticalAttribute

Opmerkingen

Met deze methode wordt het proces beëindigd zonder actieve try/finally blokken of finalizers uit te voeren.

In Windows schrijft de methode Environment.FailFast de tekenreeks message naar het gebeurtenislogboek van de Windows toepassing, maakt u een dump van uw toepassing en beëindigt u het huidige proces.

Informatie wordt gerapporteerd aan Microsoft met behulp van Windows Foutrapportage. Zie Windows Foutrapportage: Aan de slag voor meer informatie. Foutrapportage voor Microsoft bevat message en exception informatie, die details bevat die worden gebruikt om de fout te classificeren. Hoewel exception het proces niet wordt verwerkt omdat het proces wordt beëindigd, wordt de contextuele informatie die de uitzondering heeft gegenereerd, nog steeds verkregen.

Op Unix-achtige systemen wordt het bericht samen met de stacktraceringsinformatie naar de standaardfoutstroom geschreven.

Als exception dit het gevolg is nullvan een overbelasting van de methode of als exception deze niet wordt gegenereerd, werkt deze methode op dezelfde manier als de overbelasting van de FailFast(String) methode.

Gebruik de Environment.FailFast methode in plaats van de Exit methode om uw toepassing te beëindigen als de status van uw toepassing niet meer kan worden hersteld en als u de blokken en finalizers van uw toepassing try/finally uitvoert, worden programmaresources beschadigd.

Als u de methode Environment.FailFast aanroept om de uitvoering van een toepassing die wordt uitgevoerd in het Visual Studio foutopsporingsprogramma, wordt een ExecutionEngineException gegenereerd en wordt de fatalExecutionEngineError Managed Debugging Assistant (MDA) geactiveerd.