Trace.Fail Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.TraceSource.dll

Memancarkan pesan kesalahan.

Overload

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 yang akan dimuat.

Atribut

ConditionalAttribute

Contoh

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

catch ( Exception^ ) 
{
   #if defined(TRACE)
   Trace::Fail( "Unknown Option " + option + ", using the default." );
   #endif
}

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 switch.

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

   // Insert additional cases.

   default:
      #if defined(TRACE)
      Trace::Fail(String::Format("Unknown Option {0}", option));
      #endif
      result = 1.0;
      break;
}

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 pelacakan default adalah mengeluarkan message parameter ke kotak pesan saat aplikasi berjalan dalam mode antarmuka pengguna, dan ke TraceListener instans dalam Listeners koleksi.

Catatan

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 yang akan dimuat.

detailMessage

String

Pesan terperinci untuk dimunculkan.

Atribut

ConditionalAttribute

Contoh

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

catch ( Exception^ ) 
{
  #if defined(TRACE)
  Trace::Fail( String::Format( "Invalid value: {0}", value ),
      "Resetting value to newValue." );
   #endif
   value = newValue;
}

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 switch.

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

   // Insert additional cases.

   default:
      #if defined(TRACE)
      Trace::Fail( String::Format( "Unsupported option {0}", option ),
         "Result set to 1.0" );
      #endif
      result = 1.0;
      break;
}

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 agar pendengar pelacakan default menghasilkan message parameter dan detailedMessage parameter ke kotak pesan saat aplikasi berjalan dalam mode antarmuka pengguna, dan ke TraceListener instans dalam Listeners koleksi.

Catatan

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