Environment.FailFast Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Segera mengakhiri proses sebelum melaporkan pesan kesalahan. Untuk Windows, pesan kesalahan ditulis ke log peristiwa Aplikasi Windows, dan pesan dan informasi pengecualian opsional disertakan dalam pelaporan kesalahan ke Microsoft. Untuk sistem seperti Unix, pesan, bersama jejak tumpukan, ditulis ke aliran kesalahan standar.

Overload

FailFast(String)	Segera mengakhiri proses sebelum melaporkan pesan kesalahan. Untuk Windows, pesan kesalahan ditulis ke log peristiwa Aplikasi Windows, dan pesan disertakan dalam pelaporan kesalahan ke Microsoft. Untuk sistem seperti Unix, pesan, bersama jejak tumpukan, ditulis ke aliran kesalahan standar.
FailFast(String, Exception)	Segera mengakhiri proses sebelum melaporkan pesan kesalahan. Untuk Windows, pesan kesalahan ditulis ke log peristiwa Aplikasi Windows, dan informasi pesan dan pengecualian disertakan dalam pelaporan kesalahan ke Microsoft. Untuk sistem seperti Unix, pesan bersama jejak tumpukan ditulis ke aliran kesalahan standar.

FailFast(String)

Sumber:

Environment.cs

Segera mengakhiri proses sebelum melaporkan pesan kesalahan. Untuk Windows, pesan kesalahan ditulis ke log peristiwa Aplikasi Windows, dan pesan disertakan dalam pelaporan kesalahan ke Microsoft. Untuk sistem seperti Unix, pesan, bersama jejak tumpukan, ditulis ke aliran kesalahan standar.

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)

Parameter

message

String

Pesan yang menjelaskan mengapa proses dihentikan, atau null jika tidak ada penjelasan yang diberikan.

Contoh

Contoh berikut menulis entri log ke log peristiwa Aplikasi Windows saat berjalan di bawah Windows, atau menulis pesan kesalahan ke aliran kesalahan standar saat berjalan di bawah sistem seperti Unix, dan mengakhiri proses saat ini.

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.

Keterangan

Metode ini mengakhiri proses tanpa menjalankan blok atau finalizer aktif try/finally .

Di Windows, Environment.FailFast metode menulis message string ke log peristiwa Aplikasi Windows, membuat cadangan aplikasi Anda, lalu mengakhiri proses saat ini. String message juga disertakan dalam pelaporan kesalahan ke Microsoft melalui Pelaporan Galat Windows. Untuk informasi selengkapnya, lihat Pelaporan Galat Windows: Memulai.

Pada sistem seperti Unix, pesan ditulis ke aliran kesalahan standar, bersama dengan informasi pelacakan tumpukan.

Environment.FailFast Gunakan metode alih-alih Exit metode untuk mengakhiri aplikasi Anda jika status aplikasi Anda rusak di luar perbaikan, dan mengeksekusi blok dan finalizer aplikasi try/finally Anda akan merusak sumber daya program.

Memanggil Environment.FailFast metode untuk mengakhiri eksekusi aplikasi yang berjalan di debugger Visual Studio melempar ExecutionEngineException dan secara otomatis memicu fatalExecutionEngineError terkelola debugging asisten (MDA).

FailFast(String, Exception)

Sumber:

Environment.cs

Segera mengakhiri proses sebelum melaporkan pesan kesalahan. Untuk Windows, pesan kesalahan ditulis ke log peristiwa Aplikasi Windows, dan informasi pesan dan pengecualian disertakan dalam pelaporan kesalahan ke Microsoft. Untuk sistem seperti Unix, pesan bersama jejak tumpukan ditulis ke aliran kesalahan standar.

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)

Parameter

message

String

Pesan yang menjelaskan mengapa proses dihentikan, atau null jika tidak ada penjelasan yang diberikan.

exception

Exception

Pengecualian yang mewakili kesalahan yang menyebabkan penghentian. Ini biasanya pengecualian dalam blok catch .

Keterangan

Metode ini mengakhiri proses tanpa menjalankan blok atau finalizer aktif try/finally .

Di Windows, Environment.FailFast metode menulis message string ke log peristiwa Aplikasi Windows, membuat cadangan aplikasi Anda, lalu mengakhiri proses saat ini.

Informasi dilaporkan ke Microsoft dengan menggunakan Pelaporan Galat Windows. Untuk informasi selengkapnya, lihat Pelaporan Galat Windows: Memulai. Pelaporan kesalahan ke Microsoft menyertakan message informasi dan exception , yang menyediakan detail yang digunakan untuk mengklasifikasikan kesalahan. Meskipun exception tidak ditangani karena proses dihentikan, informasi kontekstual yang memunculkan pengecualian masih diperoleh.

Pada sistem seperti Unix, pesan ditulis ke aliran kesalahan standar, bersama dengan informasi pelacakan tumpukan.

Jika exception adalah null, atau jika exception tidak dilemparkan, metode ini beroperasi sama FailFast(String) dengan metode kelebihan beban.

Environment.FailFast Gunakan metode alih-alih Exit metode untuk mengakhiri aplikasi Anda jika status aplikasi Anda rusak di luar perbaikan, dan mengeksekusi blok dan finalizer aplikasi try/finally Anda akan merusak sumber daya program.

Memanggil Environment.FailFast metode untuk mengakhiri eksekusi aplikasi yang berjalan di debugger Visual Studio melempar ExecutionEngineException dan secara otomatis memicu fatalExecutionEngineError terkelola debugging asisten (MDA).