Environment.FailFast Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

A hibaüzenet jelentése előtt azonnal leállítja a folyamatot. A Windows a hibaüzenetet az alkalmazás Windows eseménynaplójába írja, és az üzenet és az opcionális kivételadatok szerepelnek a Microsoft való hibajelentésben. Unix-szerű rendszerek esetén az üzenet a veremkövetés mellett a standard hibastreambe van írva.

Túlterhelések

Name	Description
FailFast(String)	A hibaüzenet jelentése előtt azonnal leállítja a folyamatot. A Windows a hibaüzenetet az alkalmazás Windows eseménynaplójába írja, és az üzenet szerepel a Microsoft való hibajelentésben. Unix-szerű rendszerek esetén az üzenet a veremkövetés mellett a standard hibastreambe van írva.
FailFast(String, Exception)	A hibaüzenet jelentése előtt azonnal leállítja a folyamatot. A Windows esetén a hibaüzenet a Windows alkalmazás eseménynaplójába kerül, és az üzenet és a kivétel adatai szerepelnek a Microsoft való hibajelentésben. Unix-szerű rendszerek esetén a veremkövetés mellett az üzenet a standard hibastreambe lesz írva.

FailFast(String)

Forrás:

Environment.CoreCLR.cs

A hibaüzenet jelentése előtt azonnal leállítja a folyamatot. A Windows a hibaüzenetet az alkalmazás Windows eseménynaplójába írja, és az üzenet szerepel a Microsoft való hibajelentésben. Unix-szerű rendszerek esetén az üzenet a veremkövetés mellett a standard hibastreambe van írva.

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)

Paraméterek

message

String

Egy üzenet, amely elmagyarázza, hogy miért fejeződött be a folyamat, vagy null ha nincs magyarázat.

Példák

Az alábbi példa naplóbejegyzést ír a Windows alkalmazás eseménynaplójába, amikor a Windows alatt fut, vagy unix-szerű rendszer futtatásakor a hibaüzenetet a standard hibastreambe írja, és leállítja az aktuális folyamatot.

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.

Megjegyzések

Ez a metódus aktív blokkok vagy véglegesítők futtatása try/finally nélkül leállítja a folyamatot.

A Windows Environment.FailFast metódus a message sztringet az Windows alkalmazás eseménynaplójába írja, létrehoz egy memóriaképet az alkalmazásról, majd leállítja az aktuális folyamatot. A message sztring Windows hibajelentésen keresztül Microsoft történő hibajelentésben is szerepel. További információ: Windows Hibajelentés: Első lépések.

Unix-szerű rendszereken a rendszer a verem nyomkövetési információi mellett a standard hibastreambe írja az üzenetet.

A metódus helyett használja a Environment.FailFast metódust az Exit alkalmazás leállításához, ha az alkalmazás állapota a javításon túl sérült, és az alkalmazás blokkjainak try/finally és véglegesítőinek végrehajtása rontja a program erőforrásait.

A Environment.FailFast metódus meghívása a Visual Studio hibakeresőben futó alkalmazás végrehajtásának leállításához ExecutionEngineException, és automatikusan aktiválja a fatalExecutionEngineError felügyelt hibakeresési asszisztens (MDA).

FailFast(String, Exception)

Forrás:

Environment.CoreCLR.cs

A hibaüzenet jelentése előtt azonnal leállítja a folyamatot. A Windows esetén a hibaüzenet a Windows alkalmazás eseménynaplójába kerül, és az üzenet és a kivétel adatai szerepelnek a Microsoft való hibajelentésben. Unix-szerű rendszerek esetén a veremkövetés mellett az üzenet a standard hibastreambe lesz írva.

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)

Paraméterek

message

String

Egy üzenet, amely elmagyarázza, hogy miért fejeződött be a folyamat, vagy null ha nincs magyarázat.

exception

Exception

Kivétel, amely a megszakítást okozó hibát jelöli. Ez általában egy blokk kivétele catch .

Megjegyzések

Ez a metódus aktív blokkok vagy véglegesítők futtatása try/finally nélkül leállítja a folyamatot.

A Windows Environment.FailFast metódus a message sztringet az Windows alkalmazás eseménynaplójába írja, létrehoz egy memóriaképet az alkalmazásról, majd leállítja az aktuális folyamatot.

A rendszer Windows hibajelentés használatával jelenti az adatokat Microsoft. További információ: Windows Hibajelentés: Első lépések. Az Microsoft hibajelentése tartalmazza a message és exception információkat, amelyek a hiba besorolásához használt adatokat tartalmazzák. Bár exception a folyamat leállítása miatt nem kezeli a rendszer, a kivételt okozó környezeti információk továbbra is le lesznek kérve.

Unix-szerű rendszereken a rendszer a verem nyomkövetési információi mellett a standard hibastreambe írja az üzenetet.

Ha exception igen null, vagy ha exception nem dobják, ez a módszer ugyanúgy működik, mint a metódus túlterhelése FailFast(String) .

A metódus helyett használja a Environment.FailFast metódust az Exit alkalmazás leállításához, ha az alkalmazás állapota a javításon túl sérült, és az alkalmazás blokkjainak try/finally és véglegesítőinek végrehajtása rontja a program erőforrásait.

A Environment.FailFast metódus meghívása a Visual Studio hibakeresőben futó alkalmazás végrehajtásának leállításához ExecutionEngineException, és automatikusan aktiválja a fatalExecutionEngineError felügyelt hibakeresési asszisztens (MDA).