Environment.FailFast Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi di Windows Application e le informazioni facoltative sull'eccezione vengono incluse nella segnalazione degli errori a Microsoft. Per i sistemi Unix, il messaggio, insieme alla traccia dello stack, viene scritto nel flusso di errori standard.

Overload

FailFast(String)	Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi di Windows Application e il messaggio viene incluso nella segnalazione di errori a Microsoft. Per i sistemi Unix, il messaggio, insieme alla traccia dello stack, viene scritto nel flusso di errori standard.
FailFast(String, Exception)	Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi di Windows Application e le informazioni sull'eccezione vengono incluse nella segnalazione di errori a Microsoft. Per i sistemi Unix, il messaggio accanto alla traccia dello stack viene scritto nel flusso di errori standard.

FailFast(String)

Origine:

Environment.cs

Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi di Windows Application e il messaggio viene incluso nella segnalazione di errori a Microsoft. Per i sistemi Unix, il messaggio, insieme alla traccia dello stack, viene scritto nel flusso di errori 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)

Parametri

message

String

Messaggio in cui viene indicato il motivo dell'interruzione del processo o null se non è fornita alcuna spiegazione.

Esempio

L'esempio seguente scrive una voce di log nel registro eventi dell'applicazione Windows durante l'esecuzione in Windows oppure scrive il messaggio di errore nel flusso di errore standard durante l'esecuzione in un sistema unix e termina il processo corrente.

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.

Commenti

Questo metodo termina un processo senza eseguire blocchi attivi try/finally o finalizzatori.

In Windows il Environment.FailFast metodo scrive la message stringa nel registro eventi di Windows Application, crea un dump dell'applicazione e termina il processo corrente. La message stringa è inclusa anche nella segnalazione di errori a Microsoft tramite Segnalazione errori Windows. Per altre informazioni, vedere Segnalazione errori Windows: Introduzione.

Nei sistemi Unix, il messaggio viene scritto nel flusso di errori standard, insieme alle informazioni sulla traccia dello stack.

Usare il metodo anziché il metodo per terminare l'applicazione se lo Environment.FailFast stato dell'applicazione è danneggiato oltre il ripristino e l'esecuzione dei blocchi e degli finalizzatori dell'applicazione danneggiateranno le risorse del try/finally programma.Exit

La chiamata al metodo per terminare l'esecuzione Environment.FailFast di un'applicazione in esecuzione nel debugger di Visual Studio genera un ExecutionEngineException oggetto e attiva automaticamente il debug gestito irreversibileExecutionEngineError assistente (MDA).

FailFast(String, Exception)

Origine:

Environment.cs

Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi di Windows Application e le informazioni sull'eccezione vengono incluse nella segnalazione di errori a Microsoft. Per i sistemi Unix, il messaggio accanto alla traccia dello stack viene scritto nel flusso di errori 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)

Parametri

message

String

Messaggio in cui viene indicato il motivo dell'interruzione del processo o null se non è fornita alcuna spiegazione.

exception

Exception

Eccezione che rappresenta l'errore che ha causato l'interruzione. In genere si tratta di un'eccezione in un blocco catch.

Commenti

Questo metodo termina il processo senza eseguire blocchi attivi try/finally o finalizzatori.

In Windows il Environment.FailFast metodo scrive la message stringa nel registro eventi di Windows Application, crea un dump dell'applicazione e termina il processo corrente.

Le informazioni vengono segnalate a Microsoft usando Segnalazione errori Windows. Per altre informazioni, vedere Segnalazione errori Windows: Introduzione. La segnalazione degli errori a Microsoft include e exception informazioni, che fornisce message dettagli usati per classificare l'errore. Anche se exception non viene gestito perché il processo viene terminato, le informazioni contestuali che hanno generato l'eccezione vengono comunque ottenute.

Nei sistemi Unix, il messaggio viene scritto nel flusso di errori standard, insieme alle informazioni sulla traccia dello stack.

Se exception è null, o se exception non viene generata, questo metodo opera lo stesso dell'overload del FailFast(String) metodo.

Usare il metodo anziché il metodo per terminare l'applicazione se lo Environment.FailFast stato dell'applicazione è danneggiato oltre il ripristino e l'esecuzione dei blocchi e degli finalizzatori dell'applicazione danneggiateranno le risorse del try/finally programma.Exit

La chiamata al metodo per terminare l'esecuzione Environment.FailFast di un'applicazione in esecuzione nel debugger di Visual Studio genera un ExecutionEngineException oggetto e attiva automaticamente il debug gestito irreversibileExecutionEngineError assistente (MDA).