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 görüntüler.

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 yöntemini kullanır Fail .

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

Yöntemini bir switch deyiminde de kullanabilirsiniz Fail .

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 parametreyi message bir ileti kutusuna ve koleksiyondaki Listeners örneklere çıkarmaktırTraceListener.

Not

İleti kutusunun görüntülenmesi, 'nin varlığına DefaultTraceListenerbağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener, clear>, remove veya özelliğinde yöntemi çağrılarak kaldırılabilir< (System.Diagnostics.Trace.Listeners.Clear()ClearListeners).<>

Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners bir tane kaldırarak bu davranışı ö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 görüntüler.

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 yöntemini kullanır Fail .

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

Yöntemini bir switch deyiminde de kullanabilirsiniz Fail .

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ış, varsayılan izleme dinleyicisinin message uygulama kullanıcı arabirimi modunda çalıştığında parametreyi ve detailedMessage parametreyi bir ileti kutusuna ve koleksiyondaki örneklere vermesine TraceListenerListeners yöneliktir.

Not

İleti kutusunun görüntülenmesi, 'nin varlığına DefaultTraceListenerbağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener, clear>, remove veya özelliğinde yöntemi çağrılarak kaldırılabilir< (System.Diagnostics.Trace.Listeners.Clear()ClearListeners).<>

Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners bir tane kaldırarak bu davranışı özelleştirebilirsiniz.

Ayrıca bkz.

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