Trace.Fail Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

netstandard.dll, System.Diagnostics.TraceSource.dll

Memancarkan pesan kesalahan.

Overload

Nama	Deskripsi
Fail(String)	Memancarkan pesan kesalahan yang ditentukan.
Fail(String, String)	Memancarkan pesan kesalahan, dan pesan kesalahan terperinci.

Fail(String)

Sumber:

Trace.cs

Memancarkan pesan kesalahan yang ditentukan.

public:
 static void Fail(System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string? message);

[<System.Diagnostics.Conditional("TRACE")>]
static member Fail : string -> unit

Public Shared Sub Fail (message As String)

Parameter

message

String

Pesan untuk dimuat.

Atribut

ConditionalAttribute

Contoh

Contoh berikut menggunakan Fail metode untuk mencetak pesan selama penanganan pengecualian.

catch (Exception)
{
    Trace.Fail("Unknown Option " + option + ", using the default.");
}

Catch
    Trace.Fail("Unknown Option " + option1 + ", using the default.")
End Try

Anda juga dapat menggunakan Fail metode dalam pernyataan pengalihan.

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.
    default:
        Trace.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail(("Unknown Option " & option1))
        result = 1.0
End Select

Keterangan

Perilaku default untuk pendengar jejak default adalah mengeluarkan message parameter ke kotak pesan saat aplikasi berjalan dalam mode antarmuka pengguna, dan ke TraceListener instans dalam Listeners koleksi.

Nota

Tampilan kotak pesan tergantung pada keberadaan DefaultTraceListener. DefaultTraceListener Jika tidak ada dalam Listeners koleksi, kotak pesan tidak ditampilkan. DefaultTraceListener dapat dihapus dengan <jelas>, <hapus>, atau dengan memanggil Clear metode pada Listeners properti (System.Diagnostics.Trace.Listeners.Clear()).

Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau dengan menghapusnya dari, Listeners koleksi.

Lihat juga

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Fail(String, String)

Sumber:

Trace.cs

Memancarkan pesan kesalahan, dan pesan kesalahan terperinci.

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string? message, string? detailMessage);

[<System.Diagnostics.Conditional("TRACE")>]
static member Fail : string * string -> unit

Public Shared Sub Fail (message As String, detailMessage As String)

Parameter

message

String

Pesan untuk dimuat.

detailMessage

String

Pesan terperinci untuk dimunculkan.

Atribut

ConditionalAttribute

Contoh

Contoh berikut menggunakan Fail metode untuk mencetak pesan selama penanganan pengecualian.

catch (Exception)
{
    Trace.Fail("Invalid value: " + value.ToString(),
       "Resetting value to newValue.");
    value = newValue;
}

Catch
    Trace.Fail("Invalid value: " & value.ToString(), _
        "Resetting value to newValue.")
    value = newValue
End Try

Anda juga dapat menggunakan Fail metode dalam pernyataan pengalihan.

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Trace.Fail("Unsupported option " + option, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail("Unsupported option " & option1, "Result set to 1.0")
        result = 1.0
End Select

Keterangan

Perilaku default adalah untuk pendengar pelacakan default untuk menghasilkan message parameter dan detailedMessage parameter ke kotak pesan saat aplikasi berjalan dalam mode antarmuka pengguna, dan ke TraceListener instans dalam Listeners koleksi.

Nota

Tampilan kotak pesan tergantung pada keberadaan DefaultTraceListener. DefaultTraceListener Jika tidak ada dalam Listeners koleksi, kotak pesan tidak ditampilkan. DefaultTraceListener dapat dihapus dengan <jelas>, <hapus>, atau dengan memanggil Clear metode pada Listeners properti (System.Diagnostics.Trace.Listeners.Clear()).

Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau dengan menghapusnya dari, Listeners koleksi.

Lihat juga

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute