Trace.Fail Methode

  • Referenz

Definition

Namespace:
System.Diagnostics
Assembly:
System.Diagnostics.TraceSource.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Gibt eine Fehlermeldung aus.

Überlädt

Fail(String)

Gibt die angegebene Fehlermeldung aus.
Fail(String, String)

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung aus.

Fail(String)

Quelle:
Trace.cs
Quelle:
Trace.cs
Quelle:
Trace.cs

Gibt die angegebene Fehlermeldung aus.

public:
 static void Fail(System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Fail (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

Eine auszugebende Meldung.

Attribute
ConditionalAttribute

Beispiele

Im folgenden Beispiel wird die Fail -Methode zum Drucken einer Nachricht während der Ausnahmebehandlung verwendet.

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

Sie können die Fail -Methode auch in einer switch-Anweisung verwenden.

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

Hinweise

Das Standardverhalten für den Standardablaufverfolgungslistener besteht darin, den message Parameter in ein Meldungsfeld auszugeben, wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, und an die TraceListener Instanzen in der Listeners Auflistung.

Hinweis

Die Anzeige des Meldungsfelds ist abhängig vom Vorhandensein von DefaultTraceListener. Wenn sich der DefaultTraceListener nicht in der Listeners Auflistung befindet, wird das Meldungsfeld nicht angezeigt. Die DefaultTraceListener kann durch clear<>, remove<> oder durch Aufrufen der Clear -Methode für die Listeners -Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) entfernt werden.

Sie können dieses Verhalten anpassen, indem Sie der Auflistung einen TraceListener hinzufügen oder aus entfernen Listeners .

Weitere Informationen

Gilt für:

Fail(String, String)

Quelle:
Trace.cs
Quelle:
Trace.cs
Quelle:
Trace.cs

Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung aus.

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")]
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

Eine auszugebende Meldung.

detailMessage
String

Eine detaillierte Meldung, die ausgegeben werden soll.

Attribute
ConditionalAttribute

Beispiele

Im folgenden Beispiel wird die Fail -Methode zum Drucken einer Nachricht während der Ausnahmebehandlung verwendet.

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

Sie können die Fail -Methode auch in einer switch-Anweisung verwenden.

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

Hinweise

Das Standardverhalten besteht darin, dass der Standardablaufverfolgungslistener den message Parameter und den detailedMessage Parameter in ein Meldungsfeld ausgibt, wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, und an die TraceListener Instanzen in der Listeners Auflistung.

Hinweis

Die Anzeige des Meldungsfelds ist abhängig vom Vorhandensein von DefaultTraceListener. Wenn sich der DefaultTraceListener nicht in der Listeners Auflistung befindet, wird das Meldungsfeld nicht angezeigt. Die DefaultTraceListener kann durch clear<>, remove<> oder durch Aufrufen der Clear -Methode für die Listeners -Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) entfernt werden.

Sie können dieses Verhalten anpassen, indem Sie der Auflistung einen TraceListener hinzufügen oder aus entfernen Listeners .

Weitere Informationen

Gilt für: