Environment.FailFast Méthode

Source:

Environment.CoreCLR.cs

Source:

Environment.CoreCLR.cs

Source:

Environment.cs

Source:

Environment.cs

Source:

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)

Paramètres

Attributs

SecurityCriticalAttribute

Exemples

L’exemple suivant écrit une entrée de journal dans le journal des événements de l’application Windows lors de l’exécution sous Windows, ou écrit le message d’erreur dans le flux d’erreur standard lors de l’exécution sous un système unix et met fin au processus actuel.

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.

Remarques

Cette méthode met fin à un processus sans exécuter de blocs actifs try/finally ou de finaliseurs.

Sur Windows, la méthode Environment.FailFast écrit la chaîne message dans le journal des événements Windows Application, crée un vidage de votre application, puis met fin au processus actuel. La chaîne message est également incluse dans le rapport d’erreurs à Microsoft via Windows rapport d’erreurs. Pour plus d’informations, consultez Windows Rapport d’erreurs : Prise en main.

Sur les systèmes unix, le message est écrit dans le flux d’erreur standard, en même temps que les informations de suivi de la pile.

Utilisez la Environment.FailFast méthode au lieu de la Exit méthode pour mettre fin à votre application si l’état de votre application est endommagé au-delà de la réparation, et l’exécution des blocs et finaliseurs de try/finally votre application endommage les ressources du programme.

L’appel de la méthode Environment.FailFast pour arrêter l’exécution d’une application en cours d’exécution dans le débogueur Visual Studio lève un ExecutionEngineException et déclenche automatiquement le fatalExecutionEngineError managed débogage Assistant (MDA).

Source:

Environment.CoreCLR.cs

Source:

Environment.CoreCLR.cs

Source:

Environment.cs

Source:

Environment.cs

Source:

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)

Paramètres

Attributs

SecurityCriticalAttribute

Remarques

Cette méthode met fin au processus sans exécuter de blocs actifs try/finally ou de finaliseurs.

Sur Windows, la méthode Environment.FailFast écrit la chaîne message dans le journal des événements Windows Application, crée un vidage de votre application, puis met fin au processus actuel.

Les informations sont signalées à Microsoft à l’aide de Windows rapport d’erreurs. Pour plus d’informations, consultez Windows Rapport d’erreurs : Prise en main. Les rapports d’erreurs à Microsoft incluent des informations message et exception, qui fournissent des détails utilisés pour classifier l’erreur. Bien qu’elle exception ne soit pas gérée car le processus est arrêté, les informations contextuelles qui ont déclenché l’exception sont toujours obtenues.

Sur les systèmes unix, le message est écrit dans le flux d’erreur standard, en même temps que les informations de suivi de la pile.

Si exception c’est nullle cas ou si exception elle n’est pas levée, cette méthode fonctionne de la même façon que la surcharge de FailFast(String) méthode.

Utilisez la Environment.FailFast méthode au lieu de la Exit méthode pour mettre fin à votre application si l’état de votre application est endommagé au-delà de la réparation, et l’exécution des blocs et finaliseurs de try/finally votre application endommage les ressources du programme.

L’appel de la méthode Environment.FailFast pour arrêter l’exécution d’une application en cours d’exécution dans le débogueur Visual Studio lève un ExecutionEngineException et déclenche automatiquement le fatalExecutionEngineError managed débogage Assistant (MDA).