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

Definizione

Interrompe immediatamente un processo dopo aver scritto un messaggio nel log eventi dell'applicazione di Windows. Quindi, include il messaggio e le informazioni facoltative sull'eccezione nella segnalazione errori da inviare a 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.

Overload

FailFast(String) FailFast(String) FailFast(String) FailFast(String)

Interrompe immediatamente un processo dopo aver scritto un messaggio nel registro eventi dell'applicazione di Windows. Quindi, include il messaggio nella segnalazione errori da inviare a 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)

Interrompe immediatamente un processo dopo aver scritto un messaggio nel registro eventi dell'applicazione di Windows. Quindi, include il messaggio e informazioni sull'eccezione nella segnalazione errori da inviare a 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)

Interrompe immediatamente un processo dopo aver scritto un messaggio nel registro eventi dell'applicazione di Windows. Quindi, include il messaggio nella segnalazione errori da inviare a 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)

Parametri

message
String String String String

Messaggio in cui viene indicato il motivo dell'interruzione del processo o null se non è fornita alcuna spiegazione.A message that explains why the process was terminated, or null if no explanation is provided.

Esempi

Nell'esempio seguente viene scritta una voce di log nel registro eventi applicazioni di Windows e viene terminato il processo corrente.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.

Commenti

Questo metodo termina un processo senza eseguire alcun blocco o try finalizzatore attivo / finally .This method terminates a process without running any active try/finally blocks or finalizers.

Il Environment.FailFast metodo scrive la message stringa nel registro eventi applicazioni di Windows, crea un dump dell'applicazione e quindi termina il processo corrente.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 stringa viene inoltre inclusa nella segnalazione degli errori a Microsoft.The message string is also included in error reporting to Microsoft.

Usare il Environment.FailFast metodo anziché il Exit metodo per terminare l'applicazione se lo stato dell'applicazione è danneggiato oltre il ripristino ed try / finally eseguire i blocchi e i finalizzatori dell'applicazione. danneggia le risorse del programma.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.

Le informazioni vengono segnalate a Microsoft utilizzando Segnalazione errori Windows.Information is reported to Microsoft by using Windows Error Reporting. Per ulteriori informazioni, vedere segnalazione errori Windows: Introduzione.For more information, see Windows Error Reporting: Getting Started.

La chiamata Environment.FailFast al metodo per terminare l'esecuzione di un'applicazione in esecuzione nel debugger di Visual ExecutionEngineException Studio genera un'eccezione e attiva automaticamente l' Assistente al debug gestito 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).

Sicurezza

SecurityCriticalAttribute
richiede l'attendibilità totale per il chiamante immediato.requires full trust for the immediate caller. Questo membro non può essere utilizzato da codice parzialmente attendibile o trasparente.This member cannot be used by partially trusted or transparent code.

FailFast(String, Exception) FailFast(String, Exception) FailFast(String, Exception)

Interrompe immediatamente un processo dopo aver scritto un messaggio nel registro eventi dell'applicazione di Windows. Quindi, include il messaggio e informazioni sull'eccezione nella segnalazione errori da inviare a 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

Parametri

message
String String String String

Messaggio in cui viene indicato il motivo dell'interruzione del processo o null se non è fornita alcuna spiegazione.A message that explains why the process was terminated, or null if no explanation is provided.

exception
Exception Exception Exception Exception

Eccezione che rappresenta l'errore che ha causato l'interruzione.An exception that represents the error that caused the termination. In genere si tratta di un'eccezione in un blocco catch.This is typically the exception in a catch block.

Commenti

Questo metodo termina il processo senza eseguire alcun blocco o try finalizzatore attivo / finally .This method terminates the process without running any active try/finally blocks or finalizers.

Il Environment.FailFast metodo scrive la message stringa nel registro eventi applicazioni di Windows, crea un dump dell'applicazione e quindi termina il processo corrente.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.

Le informazioni vengono segnalate a Microsoft utilizzando Segnalazione errori Windows.Information is reported to Microsoft by using Windows Error Reporting. Per ulteriori informazioni, vedere segnalazione errori Windows: Introduzione.For more information, see Windows Error Reporting: Getting Started. Segnalazione errori a Microsoft include message informazioni exception su e, che fornisce i dettagli utilizzati per classificare l'errore.Error reporting to Microsoft includes message and exception information, which provides details used to classify the error. Sebbene exception non venga gestito perché il processo viene terminato, le informazioni contestuali che hanno generato l'eccezione vengono comunque ottenute.Although exception is not handled because the process is terminated, the contextual information that raised the exception is still obtained.

Se exception è nullo FailFast(String) se exception non viene generata, questo metodo funziona allo stesso modo dell'overload del metodo.If exception is null, or if exception is not thrown, this method operates the same as the FailFast(String) method overload.

Usare il Environment.FailFast metodo anziché il Exit metodo per terminare l'applicazione se lo stato dell'applicazione è danneggiato oltre il ripristino ed try / finally eseguire i blocchi e i finalizzatori dell'applicazione. danneggia le risorse del programma.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.

La chiamata Environment.FailFast al metodo per terminare l'esecuzione di un'applicazione in esecuzione nel debugger di Visual ExecutionEngineException Studio genera un'eccezione e attiva automaticamente l' Assistente al debug gestito 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).

Sicurezza

SecurityCriticalAttribute
richiede l'attendibilità totale per il chiamante immediato.requires full trust for the immediate caller. Questo membro non può essere utilizzato da codice parzialmente attendibile o trasparente.This member cannot be used by partially trusted or transparent code.

Si applica a