Environment.FailFast Environment.FailFast Environment.FailFast Environment.FailFast Method

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) FailFast(String) FailFast(String) 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) FailFast(String, Exception) 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) FailFast(String) FailFast(String) 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 String String 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.

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 termine un processus sans exécuter de blocages ou de finaliseurs actifs try. / finallyThis method terminates a process without running any active try/finally blocks or finalizers.

La Environment.FailFast méthode écrit la message chaîne 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 message chaîne est également incluse dans le rapport d’erreurs à Microsoft.The message string is also included in error reporting to Microsoft.

Utilisez la Environment.FailFast méthode à la place Exit de la méthode pour mettre fin à votre application si l’état de votre application est endommagé au-delà de la try réparation, et l' / finally exécution des blocs et finaliseurs de votre application va endommager 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 Environment.FailFast de la méthode pour mettre fin à l’exécution d’une application exécutée dans le débogueur Visual Studio lève une ExecutionEngineException exception 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) FailFast(String, Exception) 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 String String 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 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.

Remarques

Cette méthode termine le processus sans exécuter de blocages ou de finaliseurs actifs try. / finallyThis method terminates the process without running any active try/finally blocks or finalizers.

La Environment.FailFast méthode écrit la message chaîne 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 à message Microsoft exception inclut les informations et, 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. Bien exception que ne soit pas géré, 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 exception FailFast(String) est null, ou si n’est pas levée, cette méthode fonctionne de la même façon que la surcharge de méthode.If exception is null, or if exception is not thrown, this method operates the same as the FailFast(String) method overload.

Utilisez la Environment.FailFast méthode à la place Exit de la méthode pour mettre fin à votre application si l’état de votre application est endommagé au-delà de la try réparation, et l' / finally exécution des blocs et finaliseurs de votre application va endommager 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 Environment.FailFast de la méthode pour mettre fin à l’exécution d’une application exécutée dans le débogueur Visual Studio lève une ExecutionEngineException exception 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 à