Environment.FailFast Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Bir hata iletisi raporlamadan önce işlemi hemen sonlandırır. Windows için, hata iletisi Windows Uygulama olay günlüğüne yazılır ve ileti ve isteğe bağlı özel durum bilgileri Microsoft hata raporlamaya eklenir. Unix benzeri sistemler için, yığın izlemesinin yanı sıra ileti standart hata akışına yazılır.

Aşırı Yüklemeler

Name	Description
FailFast(String)	Bir hata iletisi raporlamadan önce işlemi hemen sonlandırır. Windows için hata iletisi Windows Uygulama olay günlüğüne yazılır ve hata raporlamaya Microsoft eklenir. Unix benzeri sistemler için, yığın izlemesinin yanı sıra ileti standart hata akışına yazılır.
FailFast(String, Exception)	Bir hata iletisi raporlamadan önce işlemi hemen sonlandırır. Windows için, hata iletisi Windows Uygulama olay günlüğüne yazılır ve ileti ve özel durum bilgileri Microsoft hata raporlamaya eklenir. Unix benzeri sistemler için, yığın izlemesinin yanı sıra ileti standart hata akışına yazılır.

FailFast(String)

Kaynak:

Environment.CoreCLR.cs

Bir hata iletisi raporlamadan önce işlemi hemen sonlandırır. Windows için hata iletisi Windows Uygulama olay günlüğüne yazılır ve hata raporlamaya Microsoft eklenir. Unix benzeri sistemler için, yığın izlemesinin yanı sıra ileti standart hata akışına yazılır.

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)

Parametreler

message

String

İşlemin neden sonlandırıldığını veya null herhangi bir açıklama sağlanmadığını açıklayan bir ileti.

Örnekler

Aşağıdaki örnek, Windows altında çalışırken Windows Uygulama olay günlüğüne bir günlük girdisi yazar veya Unix benzeri bir sistem altında çalışırken hata iletisini standart hata akışına yazar ve geçerli işlemi sonlandırır.

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.

Açıklamalar

Bu yöntem, etkin try/finally blokları veya sonlandırıcıları çalıştırmadan bir işlemi sonlandırır.

Windows Environment.FailFast yöntemi Windows Uygulama olay günlüğüne message dizesini yazar, uygulamanızın dökümünü oluşturur ve geçerli işlemi sonlandırır. message dizesi, Windows Hata Raporlama aracılığıyla Microsoft hata raporlamaya da eklenir. Daha fazla bilgi için bkz. Windows Hata Raporlama: Başlarken.

Unix benzeri sistemlerde ileti, yığın izleme bilgileriyle birlikte standart hata akışına yazılır.

Uygulamanızın Environment.FailFast durumu onarımdan Exit sonra zarar görürse uygulamanızı sonlandırmak için yöntemi yerine yöntemini kullanın ve uygulamanızın try/finally bloklarını ve sonlandırıcılarını yürütmek program kaynaklarını bozar.

Visual Studio hata ayıklayıcısında çalışan bir uygulamanın yürütülmesini sonlandırmak için Environment.FailFast yöntemini çağırmak bir ExecutionEngineException oluşturur ve fatalExecutionEngineError yönetilen hata ayıklama yardımcısı (MDA) otomatik olarak tetikler.

FailFast(String, Exception)

Kaynak:

Environment.CoreCLR.cs

Bir hata iletisi raporlamadan önce işlemi hemen sonlandırır. Windows için, hata iletisi Windows Uygulama olay günlüğüne yazılır ve ileti ve özel durum bilgileri Microsoft hata raporlamaya eklenir. Unix benzeri sistemler için, yığın izlemesinin yanı sıra ileti standart hata akışına yazılır.

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)

Parametreler

message

String

İşlemin neden sonlandırıldığını veya null herhangi bir açıklama sağlanmadığını açıklayan bir ileti.

exception

Exception

Sonlandırmaya neden olan hatayı temsil eden bir özel durum. Bu genellikle bir catch bloktaki özel durumdur.

Açıklamalar

Bu yöntem, etkin try/finally blokları veya sonlandırıcıları çalıştırmadan işlemi sonlandırır.

Windows Environment.FailFast yöntemi Windows Uygulama olay günlüğüne message dizesini yazar, uygulamanızın dökümünü oluşturur ve geçerli işlemi sonlandırır.

Bilgiler, Windows Hata Raporlama kullanılarak Microsoft bildirilir. Daha fazla bilgi için bkz. Windows Hata Raporlama: Başlarken. Microsoft'a hata raporlama, hatayı sınıflandırmak için kullanılan ayrıntıları sağlayan message ve exception bilgilerini içerir. İşlem sonlandırıldığından işlenmese de exception , özel durumu oluşturan bağlamsal bilgiler yine de alınır.

Unix benzeri sistemlerde ileti, yığın izleme bilgileriyle birlikte standart hata akışına yazılır.

ise exceptionnullveya atılmazsa exception , bu yöntem yöntem aşırı yüklemesi ile FailFast(String) aynı şekilde çalışır.

Uygulamanızın Environment.FailFast durumu onarımdan Exit sonra zarar görürse uygulamanızı sonlandırmak için yöntemi yerine yöntemini kullanın ve uygulamanızın try/finally bloklarını ve sonlandırıcılarını yürütmek program kaynaklarını bozar.

Visual Studio hata ayıklayıcısında çalışan bir uygulamanın yürütülmesini sonlandırmak için Environment.FailFast yöntemini çağırmak bir ExecutionEngineException oluşturur ve fatalExecutionEngineError yönetilen hata ayıklama yardımcısı (MDA) otomatik olarak tetikler.