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 oznámením chybové zprávy. V systému Windows se chybová zpráva zapisuje do protokolu událostí aplikace systému Windows a zpráva a informace o volitelné výjimce jsou součástí zasílání zpráv o chybách společnosti Microsoft. U systémů typu Unix se zpráva spolu s trasování zásobníku zapisuje do standardního datového proudu chyb.
Přetížení
FailFast(String) |
Okamžitě ukončí proces před oznámením chybové zprávy. V systému Windows se chybová zpráva zapíše do protokolu událostí aplikace systému Windows a zpráva je součástí zasílání zpráv o chybách společnosti Microsoft. U systémů typu Unix se zpráva spolu s trasování zásobníku zapisuje do standardního datového proudu chyb. |
FailFast(String, Exception) |
Okamžitě ukončí proces před oznámením chybové zprávy. V systému Windows je chybová zpráva zapsána do protokolu událostí aplikace systému Windows a zpráva a informace o výjimce jsou součástí zasílání zpráv o chybách společnosti Microsoft. U systémů typu Unix se zpráva spolu s trasování zásobníku zapisuje do standardního datového proudu chyb. |
FailFast(String)
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.cs
Okamžitě ukončí proces před oznámením chybové zprávy. V systému Windows se chybová zpráva zapíše do protokolu událostí aplikace systému Windows a zpráva je součástí zasílání zpráv o chybách společnosti Microsoft. U systémů typu Unix se zpráva spolu s 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í poskytnuto žádné vysvětlení.
- Atributy
Příklady
Následující příklad zapíše položku protokolu do protokolu událostí aplikace systému Windows při spuštění v systému Windows nebo zapíše chybovou zprávu do standardního datového proudu chyb při spuštění v systému unix-like 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 systému Windows Environment.FailFast
metoda zapíše message
řetězec do protokolu událostí aplikace systému Windows, vytvoří výpis vaší aplikace a pak ukončí aktuální proces. Řetězec message
je také součástí zasílání zpráv o chybách společnosti Microsoft prostřednictvím Zasílání zpráv o chybách systému Windows. Další informace najdete v tématu Zasílání zpráv o chybách systému Windows: Začínáme.
V unixových systémech se zpráva zapisuje do standardního datového proudu chyb spolu s informacemi o trasování zásobníku.
Environment.FailFast
Pokud je stav aplikace poškozen mimo opravu, použijte metodu Exit místo metody k ukončení aplikace a spuštění bloků a finalizátorů aplikace try
/finally
poškodí prostředky programu.
Environment.FailFast
Volání metody ukončení spuštění aplikace spuštěné v ladicím programu sady Visual Studio vyvolá ExecutionEngineException a automaticky aktivuje fatalExecutionEngineError spravované ladění asistent (MDA).
Platí pro
FailFast(String, Exception)
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.cs
- Zdroj:
- Environment.cs
Okamžitě ukončí proces před oznámením chybové zprávy. V systému Windows je chybová zpráva zapsána do protokolu událostí aplikace systému Windows a zpráva a informace o výjimce jsou součástí zasílání zpráv o chybách společnosti Microsoft. U systémů typu Unix se zpráva spolu s trasování zásobníku zapisuje 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í poskytnuto žá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 systému Windows Environment.FailFast
metoda zapíše message
řetězec do protokolu událostí aplikace systému Windows, vytvoří výpis vaší aplikace a pak ukončí aktuální proces.
Informace jsou společnosti Microsoft hlášeny pomocí Zasílání zpráv o chybách systému Windows. Další informace najdete v tématu Zasílání zpráv o chybách systému Windows: Začínáme. Zasílání zpráv o chybách společnosti Microsoft zahrnuje message
informace a exception
, které poskytují 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 unixových systémech se zpráva zapisuje 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
Pokud je stav aplikace poškozen mimo opravu, použijte metodu Exit místo metody k ukončení aplikace a spuštění bloků a finalizátorů aplikace try
/finally
poškodí prostředky programu.
Environment.FailFast
Volání metody ukončení spuštění aplikace spuštěné v ladicím programu sady Visual Studio vyvolá ExecutionEngineException a automaticky aktivuje fatalExecutionEngineError spravované ladění asistent (MDA).