Environment.FailFast Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi dell'applicazione Windows e il messaggio e le informazioni facoltative sull'eccezione sono incluse nella segnalazione errori a Microsoft. Per i sistemi simili a Unix, il messaggio, insieme all'analisi dello stack, viene scritto nel flusso di errore standard.
Overload
| Nome | Descrizione |
|---|---|
| FailFast(String) |
Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi dell'applicazione Windows e il messaggio viene incluso nella segnalazione errori a Microsoft. Per i sistemi simili a Unix, il messaggio, insieme all'analisi dello stack, viene scritto nel flusso di errore 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 dell'applicazione Windows e il messaggio e le informazioni sulle eccezioni vengono incluse nella segnalazione errori a Microsoft. Per i sistemi simili a Unix, il messaggio insieme all'analisi dello stack viene scritto nel flusso di errore standard. |
FailFast(String)
Termina immediatamente il processo prima di segnalare un messaggio di errore. Per Windows, il messaggio di errore viene scritto nel registro eventi dell'applicazione Windows e il messaggio viene incluso nella segnalazione errori a Microsoft. Per i sistemi simili a Unix, il messaggio, insieme all'analisi dello stack, viene scritto nel flusso di errore standard.
public:
static void FailFast(System::String ^ message);
[System.Security.SecurityCritical]
public static void FailFast(string message);
public static void FailFast(string message);
[<System.Security.SecurityCritical>]
static member FailFast : string -> unit
static member FailFast : string -> unit
Public Shared Sub FailFast (message As String)
Parametri
- message
- String
Messaggio che spiega perché il processo è stato terminato o null se non viene fornita alcuna spiegazione.
- Attributi
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 simile a 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 metodo Environment.FailFast scrive la stringa message nel registro eventi dell'applicazione Windows, crea un dump dell'applicazione e quindi termina il processo corrente. La stringa message è inclusa anche nella segnalazione errori per Microsoft tramite Windows segnalazione errori. Per altre informazioni, vedere Windows Segnalazione errori: Introduzione.
Nei sistemi simili a Unix, il messaggio viene scritto nel flusso di errore standard, insieme alle informazioni di analisi dello stack.
Usare il Environment.FailFast metodo anziché il metodo per terminare l'applicazione Exit se lo stato dell'applicazione è danneggiato oltre il ripristino e l'esecuzione dei blocchi e dei finalizzatori dell'applicazione try/finally danneggia le risorse del programma.
La chiamata al metodo Environment.FailFast per terminare l'esecuzione di un'applicazione in esecuzione nel debugger Visual Studio genera un ExecutionEngineException e attiva automaticamente l'assistente al debug gestito fatalExecutionEngineError (MDA).
Si applica a
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 dell'applicazione Windows e il messaggio e le informazioni sulle eccezioni vengono incluse nella segnalazione errori a Microsoft. Per i sistemi simili a Unix, il messaggio insieme all'analisi dello stack viene scritto nel flusso di errore standard.
public:
static void FailFast(System::String ^ message, Exception ^ exception);
[System.Security.SecurityCritical]
public static void FailFast(string message, Exception exception);
public static void FailFast(string message, Exception exception);
[<System.Security.SecurityCritical>]
static member FailFast : string * Exception -> unit
static member FailFast : string * Exception -> unit
Public Shared Sub FailFast (message As String, exception As Exception)
Parametri
- message
- String
Messaggio che spiega perché il processo è stato terminato o null se non viene fornita alcuna spiegazione.
- exception
- Exception
Eccezione che rappresenta l'errore che ha causato la chiusura. Si tratta in genere dell'eccezione in un catch blocco.
- Attributi
Commenti
Questo metodo termina il processo senza eseguire blocchi attivi try/finally o finalizzatori.
In Windows il metodo Environment.FailFast scrive la stringa message nel registro eventi dell'applicazione Windows, crea un dump dell'applicazione e quindi termina il processo corrente.
Le informazioni vengono segnalate a Microsoft usando Windows segnalazione errori. Per altre informazioni, vedere Windows Segnalazione errori: Introduzione. La segnalazione degli errori a Microsoft include informazioni message e exception, che fornisce i dettagli usati per classificare l'errore. Anche se exception non viene gestito perché il processo viene terminato, vengono comunque ottenute le informazioni contestuali che hanno generato l'eccezione.
Nei sistemi simili a Unix, il messaggio viene scritto nel flusso di errore standard, insieme alle informazioni di analisi dello stack.
Se exception è nullo se exception non viene generata, questo metodo funziona allo stesso modo dell'overload del FailFast(String) metodo.
Usare il Environment.FailFast metodo anziché il metodo per terminare l'applicazione Exit se lo stato dell'applicazione è danneggiato oltre il ripristino e l'esecuzione dei blocchi e dei finalizzatori dell'applicazione try/finally danneggia le risorse del programma.
La chiamata al metodo Environment.FailFast per terminare l'esecuzione di un'applicazione in esecuzione nel debugger Visual Studio genera un ExecutionEngineException e attiva automaticamente l'assistente al debug gestito fatalExecutionEngineError (MDA).