Environment.FailFast Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Okamžitě ukončí proces před hlášením chybové zprávy. V případě Windows se chybová zpráva zapíše do protokolu událostí Windows aplikace a zpráva a volitelné informace o výjimce se zahrnou do hlášení chyb Microsoft. U systémů unixových systémů se zpráva vedle trasování zásobníku zapisuje do standardního datového proudu chyb.
Přetížení
| Name | Description |
|---|---|
| FailFast(String) |
Okamžitě ukončí proces před hlášením chybové zprávy. Pro Windows se chybová zpráva zapíše do protokolu událostí Windows aplikace a zpráva se zahrne do hlášení chyb pro Microsoft. U systémů unixových systémů se zpráva vedle trasování zásobníku zapisuje do standardního datového proudu chyb. |
| FailFast(String, Exception) |
Okamžitě ukončí proces před hlášením chybové zprávy. V případě Windows se chybová zpráva zapíše do protokolu událostí Windows aplikace a zpráva a informace o výjimce se zahrnou do hlášení chyb Microsoft. U systémů unixových systémů se zpráva vedle trasování zásobníku zapíše do standardního datového proudu chyb. |
FailFast(String)
- Zdroj:
- Environment.CoreCLR.cs
- Zdroj:
- Environment.CoreCLR.cs
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.CoreCLR.cs
Okamžitě ukončí proces před hlášením chybové zprávy. Pro Windows se chybová zpráva zapíše do protokolu událostí Windows aplikace a zpráva se zahrne do hlášení chyb pro Microsoft. U systémů unixových systémů se zpráva vedle trasování zásobníku zapisuje do standardního datového proudu chyb.
public:
static void FailFast(System::String ^ message);
[System.Security.SecurityCritical]
public static void FailFast(string message);
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)
Parametry
- message
- String
Zpráva, která vysvětluje, proč byl proces ukončen, nebo null pokud není k dispozici žádné vysvětlení.
- Atributy
Příklady
Následující příklad zapíše položku protokolu do protokolu událostí Windows aplikace při spuštění pod Windows nebo zapíše chybovou zprávu do standardního chybového proudu při spuštění v systému podobném systému Unix a ukončí aktuální proces.
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.
Poznámky
Tato metoda ukončí proces bez spuštění aktivních try/finally bloků nebo finalizátorů.
V Windows metoda Environment.FailFast zapíše řetězec message do protokolu událostí Windows Aplikace, vytvoří výpis aplikace a pak ukončí aktuální proces. Řetězec message je také součástí zasílání zpráv o chybách Microsoft prostřednictvím Windows zasílání zpráv o chybách. Další informace najdete v tématu Windows Zasílání zpráv o chybách: Začínáme.
V systémech Unix je zpráva zapsána do standardního datového proudu chyb spolu s informacemi o trasování zásobníku.
Environment.FailFast Tuto metodu Exit použijte místo metody k ukončení aplikace, pokud je stav aplikace poškozen nad rámec opravy a spuštění bloků a finalizátorů aplikace try/finally poškodí prostředky programu.
Volání metody Environment.FailFast pro ukončení provádění aplikace spuštěné v ladicím programu Visual Studio vyvolá ExecutionEngineException a automaticky aktivuje fatalExecutionEngineError spravovaného pomocníka ladění (MDA).
Platí pro
FailFast(String, Exception)
- Zdroj:
- Environment.CoreCLR.cs
- Zdroj:
- Environment.CoreCLR.cs
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.CoreCLR.cs
Okamžitě ukončí proces před hlášením chybové zprávy. V případě Windows se chybová zpráva zapíše do protokolu událostí Windows aplikace a zpráva a informace o výjimce se zahrnou do hlášení chyb Microsoft. U systémů unixových systémů se zpráva vedle trasování zásobníku zapíše do standardního datového proudu chyb.
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);
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)
Parametry
- message
- String
Zpráva, která vysvětluje, proč byl proces ukončen, nebo null pokud není k dispozici žádné vysvětlení.
- exception
- Exception
Výjimka, která představuje chybu, která způsobila ukončení. Obvykle se jedná o výjimku v catch bloku.
- Atributy
Poznámky
Tato metoda ukončí proces bez spuštění aktivních try/finally bloků nebo finalizátorů.
V Windows metoda Environment.FailFast zapíše řetězec message do protokolu událostí Windows Aplikace, vytvoří výpis aplikace a pak ukončí aktuální proces.
Informace jsou hlášeny Microsoft pomocí Windows zasílání zpráv o chybách. Další informace najdete v tématu Windows Zasílání zpráv o chybách: Začínáme. Zasílání zpráv o chybách Microsoft zahrnuje informace o message a exception, které obsahují podrobnosti použité ke klasifikaci chyby. I když exception není zpracován, protože proces je ukončen, kontextové informace, které vyvolaly výjimku, jsou stále získány.
V systémech Unix je zpráva zapsána do standardního datového proudu chyb spolu s informacemi o trasování zásobníku.
Pokud exception je null, nebo pokud exception není vyvolán, tato metoda funguje stejně jako FailFast(String) přetížení metody.
Environment.FailFast Tuto metodu Exit použijte místo metody k ukončení aplikace, pokud je stav aplikace poškozen nad rámec opravy a spuštění bloků a finalizátorů aplikace try/finally poškodí prostředky programu.
Volání metody Environment.FailFast pro ukončení provádění aplikace spuštěné v ladicím programu Visual Studio vyvolá ExecutionEngineException a automaticky aktivuje fatalExecutionEngineError spravovaného pomocníka ladění (MDA).