Trace.Fail Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TraceSource.dll

Bir hata iletisi yayar.

Aşırı Yüklemeler

Fail(String)	Belirtilen hata iletisini yayar.
Fail(String, String)	Bir hata iletisi ve ayrıntılı bir hata iletisi yayar.

Fail(String)

Kaynak:

Trace.cs

Belirtilen hata iletisini yayar.

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)

Parametreler

message

String

Yaymak için bir ileti.

Öznitelikler

ConditionalAttribute

Örnekler

Aşağıdaki örnek, özel durum işleme sırasında bir iletiyi yazdırmak için Fail yöntemini kullanır.

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

Switch deyiminde Fail yöntemini de kullanabilirsiniz.

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

Açıklamalar

Varsayılan izleme dinleyicisi için varsayılan davranış, uygulama kullanıcı arabirimi modunda çalıştırıldığında bir ileti kutusuna ve Listeners koleksiyonundaki TraceListener örneklerine message parametresini çıkarmaktır.

Not

İleti kutusunun görüntülenmesi, DefaultTraceListenervarlığına bağlıdır. DefaultTraceListener Listeners koleksiyonunda değilse, ileti kutusu görüntülenmez. DefaultTraceListener <temizleme>tarafından, <>kaldırarak veya Listeners özelliğinde (System.Diagnostics.Trace.Listeners.Clear()) Clear yöntemi çağrılarak kaldırılabilir.

Bu davranışı, Listeners koleksiyonuna bir TraceListener ekleyerek veya koleksiyonundan kaldırarak özelleştirebilirsiniz.

Ayrıca bkz.

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

Fail(String, String)

Kaynak:

Trace.cs

Bir hata iletisi ve ayrıntılı bir hata iletisi yayar.

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)

Parametreler

message

String

Yaymak için bir ileti.

detailMessage

String

Yaymak için ayrıntılı bir ileti.

Öznitelikler

ConditionalAttribute

Örnekler

Aşağıdaki örnek, özel durum işleme sırasında bir iletiyi yazdırmak için Fail yöntemini kullanır.

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

Switch deyiminde Fail yöntemini de kullanabilirsiniz.

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

Açıklamalar

Varsayılan davranış, uygulama kullanıcı arabirimi modunda çalıştırıldığında message parametresini ve detailedMessage parametresini bir ileti kutusuna ve Listeners koleksiyonundaki TraceListener örneklerine çıkarmak için varsayılan izleme dinleyicisi içindir.

Not

İleti kutusunun görüntülenmesi, DefaultTraceListenervarlığına bağlıdır. DefaultTraceListener Listeners koleksiyonunda değilse, ileti kutusu görüntülenmez. DefaultTraceListener <temizleme>tarafından, <>kaldırarak veya Listeners özelliğinde (System.Diagnostics.Trace.Listeners.Clear()) Clear yöntemi çağrılarak kaldırılabilir.

Bu davranışı, Listeners koleksiyonuna bir TraceListener ekleyerek veya koleksiyonundan kaldırarak özelleştirebilirsiniz.

Ayrıca bkz.

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