Environment.FailFast Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Natychmiast kończy proces przed zgłoszeniem komunikatu o błędzie. W przypadku systemu Windows komunikat o błędzie jest zapisywany w dzienniku zdarzeń aplikacji systemu Windows, a komunikat i opcjonalne informacje o wyjątku są uwzględniane w raportowaniu błędów do firmy Microsoft. W przypadku systemów podobnych do systemu Unix komunikat wraz ze śladem stosu jest zapisywany w standardowym strumieniu błędów.

Przeciążenia

FailFast(String)	Natychmiast kończy proces przed zgłoszeniem komunikatu o błędzie. W przypadku systemu Windows komunikat o błędzie jest zapisywany w dzienniku zdarzeń aplikacji systemu Windows, a komunikat jest uwzględniany w raportowaniu błędów do firmy Microsoft. W przypadku systemów podobnych do systemu Unix komunikat wraz ze śladem stosu jest zapisywany w standardowym strumieniu błędów.
FailFast(String, Exception)	Natychmiast kończy proces przed zgłoszeniem komunikatu o błędzie. W przypadku systemu Windows komunikat o błędzie jest zapisywany w dzienniku zdarzeń aplikacji systemu Windows, a komunikat i informacje o wyjątku są uwzględniane w raportowaniu błędów do firmy Microsoft. W przypadku systemów podobnych do systemu Unix komunikat wraz ze śladem stosu jest zapisywany w standardowym strumieniu błędów.

FailFast(String)

Źródło:

Environment.cs

Natychmiast kończy proces przed zgłoszeniem komunikatu o błędzie. W przypadku systemu Windows komunikat o błędzie jest zapisywany w dzienniku zdarzeń aplikacji systemu Windows, a komunikat jest uwzględniany w raportowaniu błędów do firmy Microsoft. W przypadku systemów podobnych do systemu Unix komunikat wraz ze śladem stosu jest zapisywany w standardowym strumieniu błędów.

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)

Parametry

message

String

Komunikat wyjaśniający, dlaczego proces został zakończony lub null jeśli nie podano wyjaśnienia.

Przykłady

Poniższy przykład zapisuje wpis dziennika w dzienniku zdarzeń aplikacji systemu Windows podczas uruchamiania w systemie Windows lub zapisuje komunikat o błędzie do standardowego strumienia błędów podczas działania w systemie przypominającym system Unix i kończy bieżący proces.

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.

Uwagi

Ta metoda kończy proces bez uruchamiania aktywnych try/finally bloków lub finalizatorów.

W systemie Windows Environment.FailFast metoda zapisuje message ciąg w dzienniku zdarzeń aplikacji systemu Windows, tworzy zrzut aplikacji, a następnie kończy bieżący proces. Ciąg message jest również uwzględniony w raportowaniu błędów do firmy Microsoft za pośrednictwem Raportowanie błędów systemu Windows. Aby uzyskać więcej informacji, zobacz Raportowanie błędów systemu Windows: Wprowadzenie.

W systemach podobnych do systemu Unix komunikat jest zapisywany w standardowym strumieniu błędów wraz z informacjami śledzenia stosu.

Environment.FailFast Użyj metody zamiast Exit metody , aby zakończyć działanie aplikacji, jeśli stan aplikacji zostanie uszkodzony poza naprawą, a wykonanie bloków aplikacji try/finally i finalizatorów spowoduje uszkodzenie zasobów programu.

Environment.FailFast Wywołanie metody w celu zakończenia wykonywania aplikacji uruchomionej w debugerze programu Visual Studio powoduje, ExecutionEngineException że funkcja i automatycznie wyzwala debugowanie zarządzane przez błąd fatalExecutionEngineError asystent (MDA).

FailFast(String, Exception)

Źródło:

Environment.cs

Natychmiast kończy proces przed zgłoszeniem komunikatu o błędzie. W przypadku systemu Windows komunikat o błędzie jest zapisywany w dzienniku zdarzeń aplikacji systemu Windows, a komunikat i informacje o wyjątku są uwzględniane w raportowaniu błędów do firmy Microsoft. W przypadku systemów podobnych do systemu Unix komunikat wraz ze śladem stosu jest zapisywany w standardowym strumieniu błędów.

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)

Parametry

message

String

Komunikat wyjaśniający, dlaczego proces został zakończony lub null jeśli nie podano wyjaśnienia.

exception

Exception

Wyjątek reprezentujący błąd, który spowodował zakończenie. Jest to zazwyczaj wyjątek w catch bloku.

Uwagi

Ta metoda kończy proces bez uruchamiania aktywnych try/finally bloków lub finalizatorów.

W systemie Windows Environment.FailFast metoda zapisuje message ciąg w dzienniku zdarzeń aplikacji systemu Windows, tworzy zrzut aplikacji, a następnie kończy bieżący proces.

Informacje są zgłaszane do firmy Microsoft przy użyciu Raportowanie błędów systemu Windows. Aby uzyskać więcej informacji, zobacz Raportowanie błędów systemu Windows: Wprowadzenie. Raportowanie błędów w firmie Microsoft zawiera message informacje i exception informacje, które zawierają szczegółowe informacje używane do klasyfikowania błędu. Chociaż exception nie jest obsługiwane, ponieważ proces został zakończony, kontekstowe informacje, które zgłosiły wyjątek, są nadal uzyskiwane.

W systemach podobnych do systemu Unix komunikat jest zapisywany w standardowym strumieniu błędów wraz z informacjami śledzenia stosu.

Jeśli exception wartość to null, lub jeśli exception nie jest zgłaszana, ta metoda działa tak samo jak FailFast(String) przeciążenie metody.

Environment.FailFast Użyj metody zamiast Exit metody , aby zakończyć działanie aplikacji, jeśli stan aplikacji zostanie uszkodzony poza naprawą, a wykonanie bloków aplikacji try/finally i finalizatorów spowoduje uszkodzenie zasobów programu.

Environment.FailFast Wywołanie metody w celu zakończenia wykonywania aplikacji uruchomionej w debugerze programu Visual Studio powoduje, ExecutionEngineException że funkcja i automatycznie wyzwala debugowanie zarządzane przez błąd fatalExecutionEngineError asystent (MDA).