Environment.FailFast Metod

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)

Parametrar

Attribut

SecurityCriticalAttribute

Exempel

I följande exempel skrivs en loggpost till händelseloggen Windows Program när den körs under Windows, eller skriver felmeddelandet till standardfelströmmen när den körs under ett Unix-liknande system och avslutar den aktuella processen.

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.

Kommentarer

Den här metoden avslutar en process utan att köra några aktiva try/finally block eller finalizers.

På Windows skriver metoden Environment.FailFast strängen message till händelseloggen Windows Application, skapar en dump av ditt program och avslutar sedan den aktuella processen. Strängen message ingår också i felrapportering till Microsoft via Windows felrapportering. Mer information finns i Windows Felrapportering: Komma igång.

I Unix-liknande system skrivs meddelandet till standardfelströmmen tillsammans med stackspårningsinformationen.

Environment.FailFast Använd metoden i stället för Exit metoden för att avsluta programmet om programmets tillstånd är skadat bortom reparation, och om du kör programmets try/finally block och finalizers skadas programresurserna.

Om du anropar metoden Environment.FailFast för att avsluta körningen av ett program som körs i Visual Studio utlöser felsökaren en ExecutionEngineException och utlöser automatiskt fatalExecutionEngineError managed debugging assistant (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)

Parametrar

Attribut

SecurityCriticalAttribute

Kommentarer

Den här metoden avslutar processen utan att köra några aktiva try/finally block eller finalizers.

På Windows skriver metoden Environment.FailFast strängen message till händelseloggen Windows Application, skapar en dump av ditt program och avslutar sedan den aktuella processen.

Information rapporteras till Microsoft med hjälp av Windows felrapportering. Mer information finns i Windows Felrapportering: Komma igång. Felrapportering till Microsoft innehåller information om message och exception, som innehåller information som används för att klassificera felet. Även om exception den inte hanteras eftersom processen avslutas, hämtas fortfarande den sammanhangsinformation som genererade undantaget.

I Unix-liknande system skrivs meddelandet till standardfelströmmen tillsammans med stackspårningsinformationen.

Om exception är null, eller om exception inte utlöses, fungerar den här metoden på samma sätt som FailFast(String) metodens överlagring.

Environment.FailFast Använd metoden i stället för Exit metoden för att avsluta programmet om programmets tillstånd är skadat bortom reparation, och om du kör programmets try/finally block och finalizers skadas programresurserna.

Om du anropar metoden Environment.FailFast för att avsluta körningen av ett program som körs i Visual Studio utlöser felsökaren en ExecutionEngineException och utlöser automatiskt fatalExecutionEngineError managed debugging assistant (MDA).