Environment.FailFast Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Arrête immédiatement le processus avant de signaler un message d’erreur. Pour Windows, le message d’erreur est écrit dans le journal des événements des applications Windows, et le message et les informations d’exception facultatives sont incluses dans les rapports d’erreurs à Microsoft. Pour les systèmes de type Unix, le message, en plus de la trace de pile, est écrit dans le flux d’erreurs standard.

Surcharges

FailFast(String)	Arrête immédiatement le processus avant de signaler un message d’erreur. Pour Windows, le message d’erreur est écrit dans le journal des événements des applications Windows et le message est inclus dans les rapports d’erreurs à Microsoft. Pour les systèmes de type Unix, le message, en plus de la trace de pile, est écrit dans le flux d’erreurs standard.
FailFast(String, Exception)	Arrête immédiatement le processus avant de signaler un message d’erreur. Pour Windows, le message d’erreur est écrit dans le journal des événements de l’application Windows, et les informations de message et d’exception sont incluses dans les rapports d’erreurs à Microsoft. Pour les systèmes de type Unix, le message à côté de la trace de pile est écrit dans le flux d’erreurs standard.

FailFast(String)

Source:

Environment.cs

Arrête immédiatement le processus avant de signaler un message d’erreur. Pour Windows, le message d’erreur est écrit dans le journal des événements des applications Windows et le message est inclus dans les rapports d’erreurs à Microsoft. Pour les systèmes de type Unix, le message, en plus de la trace de pile, est écrit dans le flux d’erreurs standard.

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ètres

message

String

Message qui explique pourquoi le processus s'est terminé, ou null si aucune explication n'est fournie.

Exemples

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

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 Environment.FailFast méthode écrit la chaîne dans message le journal des événements des applications Windows, crée un vidage de votre application, puis met fin au processus en cours. La message chaîne est également incluse dans les rapports d’erreurs à Microsoft via Rapport d'erreurs Windows. Pour plus d’informations, consultez Rapport d'erreurs Windows : Prise en main.

Sur les systèmes de type Unix, le message est écrit dans le flux d’erreurs standard, à côté des informations de trace de 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 que l’exécution des blocs et des finaliseurs de votre application endommage les ressources du try/finally programme.

L’appel de la Environment.FailFast méthode pour mettre fin à l’exécution d’une application s’exécutant dans le débogueur Visual Studio lève un ExecutionEngineException et déclenche automatiquement le assistant de débogage managé fatalExecutionEngineError (MDA).

FailFast(String, Exception)

Source:

Environment.cs

Arrête immédiatement le processus avant de signaler un message d’erreur. Pour Windows, le message d’erreur est écrit dans le journal des événements de l’application Windows, et les informations de message et d’exception sont incluses dans les rapports d’erreurs à Microsoft. Pour les systèmes de type Unix, le message à côté de la trace de pile est écrit dans le flux d’erreurs standard.

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ètres

message

String

Message qui explique pourquoi le processus s'est terminé, ou null si aucune explication n'est fournie.

exception

Exception

Exception qui représente l'erreur à l'origine de l'arrêt. Il s'agit en général de l'exception dans un bloc catch.

Remarques

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

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

Les informations sont communiquées à Microsoft à l’aide de Rapport d'erreurs Windows. Pour plus d’informations, consultez Rapport d'erreurs Windows : Prise en main. Les rapports d’erreurs à Microsoft incluent message et exception des informations, qui fournissent les détails utilisés pour classer l’erreur. Bien que ne soient exception pas gérées, car le processus est terminé, les informations contextuelles qui ont déclenché l’exception sont toujours obtenues.

Sur les systèmes de type Unix, le message est écrit dans le flux d’erreurs standard, à côté des informations de trace de pile.

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

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 que l’exécution des blocs et des finaliseurs de votre application endommage les ressources du try/finally programme.

L’appel de la Environment.FailFast méthode pour mettre fin à l’exécution d’une application s’exécutant dans le débogueur Visual Studio lève un ExecutionEngineException et déclenche automatiquement le assistant de débogage managé fatalExecutionEngineError (MDA).