Environment.FailFast Méthode

Définition

Met immédiatement fin à un processus après avoir écrit un message dans le journal des événements des applications Windows, puis inclut le message et les informations sur les exceptions facultatives dans le rapport d'erreurs à Microsoft.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and optional exception information in error reporting to Microsoft.

Surcharges

FailFast(String)

Met immédiatement fin à un processus après avoir écrit un message dans le journal des événements des applications Windows, puis inclut le message dans le rapport d'erreurs à Microsoft.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message in error reporting to Microsoft.

FailFast(String, Exception)

Met immédiatement fin à un processus après avoir écrit un message dans le journal des événements des applications Windows, puis inclut le message et les informations sur les exceptions dans le rapport d'erreurs à Microsoft.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and exception information in error reporting to Microsoft.

FailFast(String)

Met immédiatement fin à un processus après avoir écrit un message dans le journal des événements des applications Windows, puis inclut le message dans le rapport d'erreurs à Microsoft.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message in error reporting to Microsoft.

public:
 static void FailFast(System::String ^ message);
[System.Security.SecurityCritical]
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.A message that explains why the process was terminated, or null if no explanation is provided.

Attributs

Exemples

L’exemple suivant écrit une entrée de journal dans le journal des événements des applications Windows et met fin au processus en cours.The following example writes a log entry to the Windows Application event log and terminates the current process.

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.
*/
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 try/de blocs ou de finaliseurs finally actif.This method terminates a process without running any active try/finally blocks or finalizers.

La méthode Environment.FailFast écrit la chaîne message dans le journal des événements des applications Windows, crée un dump de votre application, puis termine le processus en cours.The Environment.FailFast method writes the message string to the Windows Application event log, creates a dump of your application, and then terminates the current process. La chaîne de message est également incluse dans le rapport d’erreurs à Microsoft.The message string is also included in error reporting to Microsoft.

Utilisez la méthode Environment.FailFast au lieu de la méthode Exit pour mettre fin à votre application si l’état de votre application est endommagé au-delà de la réparation, et si vous exécutez le tryde l’application /finally blocs et finaliseurs corrompront les ressources du programme.Use the Environment.FailFast method instead of the Exit method to terminate your application if the state of your application is damaged beyond repair, and executing your application's try/finally blocks and finalizers will corrupt program resources.

Les informations sont signalées à Microsoft à l’aide de Rapport d’erreurs Windows.Information is reported to Microsoft by using Windows Error Reporting. Pour plus d’informations, consultez rapport d’erreurs Windows : prise en main.For more information, see Windows Error Reporting: Getting Started.

L’appel de la méthode Environment.FailFast pour terminer l’exécution d’une application exécutée dans le débogueur Visual Studio lève une ExecutionEngineException et déclenche automatiquement l' Assistant Débogage managé (MDA) fatalExecutionEngineError.Calling the Environment.FailFast method to terminate execution of an application running in the Visual Studio debugger throws an ExecutionEngineException and automatically triggers the fatalExecutionEngineError managed debugging assistant (MDA).

Sécurité

SecurityCriticalAttribute
requiert une confiance totale pour l’appelant immédiat.requires full trust for the immediate caller. Ce membre ne peut pas être utilisé par du code de confiance partielle ou transparent.This member cannot be used by partially trusted or transparent code.

FailFast(String, Exception)

Met immédiatement fin à un processus après avoir écrit un message dans le journal des événements des applications Windows, puis inclut le message et les informations sur les exceptions dans le rapport d'erreurs à Microsoft.Immediately terminates a process after writing a message to the Windows Application event log, and then includes the message and exception information in error reporting to Microsoft.

public:
 static void FailFast(System::String ^ message, Exception ^ exception);
[System.Security.SecurityCritical]
public static void FailFast (string message, Exception exception);
static member FailFast : string * Exception -> unit

Paramètres

message
String

Message qui explique pourquoi le processus s'est terminé, ou null si aucune explication n'est fournie.A message that explains why the process was terminated, or null if no explanation is provided.

exception
Exception

Exception qui représente l'erreur à l'origine de l'arrêt.An exception that represents the error that caused the termination. Il s'agit en général de l'exception dans un bloc catch.This is typically the exception in a catch block.

Attributs

Remarques

Cette méthode termine le processus sans exécuter les try/finally ni les blocs de finalisation actifs.This method terminates the process without running any active try/finally blocks or finalizers.

La méthode Environment.FailFast écrit la chaîne message dans le journal des événements des applications Windows, crée un dump de votre application, puis termine le processus en cours.The Environment.FailFast method writes the message string to the Windows Application event log, creates a dump of your application, and then terminates the current process.

Les informations sont signalées à Microsoft à l’aide de Rapport d’erreurs Windows.Information is reported to Microsoft by using Windows Error Reporting. Pour plus d’informations, consultez rapport d’erreurs Windows : prise en main.For more information, see Windows Error Reporting: Getting Started. Le rapport d’erreurs à Microsoft inclut des informations sur les message et les exception, qui fournissent des détails permettant de classer l’erreur.Error reporting to Microsoft includes message and exception information, which provides details used to classify the error. Même si exception n’est pas gérée car le processus est terminé, les informations contextuelles qui ont levé l’exception sont toujours obtenues.Although exception is not handled because the process is terminated, the contextual information that raised the exception is still obtained.

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).If exception is null, or if exception is not thrown, this method operates the same as the FailFast(String) method overload.

Utilisez la méthode Environment.FailFast au lieu de la méthode Exit pour mettre fin à votre application si l’état de votre application est endommagé au-delà de la réparation, et si vous exécutez le tryde l’application /finally blocs et finaliseurs corrompront les ressources du programme.Use the Environment.FailFast method instead of the Exit method to terminate your application if the state of your application is damaged beyond repair, and executing your application's try/finally blocks and finalizers will corrupt program resources.

L’appel de la méthode Environment.FailFast pour terminer l’exécution d’une application exécutée dans le débogueur Visual Studio lève une ExecutionEngineException et déclenche automatiquement l' Assistant Débogage managé (MDA) fatalExecutionEngineError.Calling the Environment.FailFast method to terminate execution of an application running in the Visual Studio debugger throws an ExecutionEngineException and automatically triggers the fatalExecutionEngineError managed debugging assistant (MDA).

Sécurité

SecurityCriticalAttribute
requiert une confiance totale pour l’appelant immédiat.requires full trust for the immediate caller. Ce membre ne peut pas être utilisé par du code de confiance partielle ou transparent.This member cannot be used by partially trusted or transparent code.

S’applique à