Debug.Fail Methode

Definition

Namespace:

System.Diagnostics

Assemblys:

netstandard.dll, System.Runtime.dll

Gibt eine Fehlermeldung aus.

Überlädt

Name	Beschreibung
Fail(String, String)	Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung aus.
Fail(String)	Gibt die angegebene Fehlermeldung aus.

Fail(String, String)

Quelle:

Debug.cs

Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung aus.

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

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

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

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

Parameter

message

String

Eine zu sendende Nachricht.

detailMessage

String

Eine detaillierte Nachricht, 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)
{
    Debug.Fail("Invalid value: " + value.ToString(),
       "Resetting value to newValue.");
    value = newValue;
}

Catch e As Exception
    Debug.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 (option1)
{
    case MyOption.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option1, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

Hinweise

Das Standardverhalten besteht darin, dass die DefaultTraceListener Nachricht in ein Meldungsfeld ausgegeben wird, wenn die Anwendung im Benutzeroberflächenmodus und in den TraceListener Instanzen in der Listeners Auflistung ausgeführt wird.

Hinweis

Die Anzeige des Meldungsfelds hängt vom Vorhandensein der DefaultTraceListenerMeldung ab. Wenn sich die DefaultTraceListenerListeners Auflistung nicht befindet, wird das Meldungsfeld nicht angezeigt. Dies DefaultTraceListener kann durch das <Löschen>, das <Entfernen> 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 eine TraceListener der Auflistung hinzufügen oder aus dieser Listeners entfernen.

Weitere Informationen

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

Fail(String)

Quelle:

Debug.cs

Gibt die angegebene Fehlermeldung aus.

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

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

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

Public Shared Sub Fail (message As String)

Parameter

message

String

Eine zu sendende Nachricht.

Attribute

ConditionalAttribute

Beispiele

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

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

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", 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:
        Debug.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case myOption1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail(("Unknown Option " & myOption1.ToString))
        result = 1.0
End Select

Hinweise

Das Standardverhalten besteht darin, dass die DefaultTraceListener Nachricht in ein Meldungsfeld ausgegeben wird, wenn die Anwendung im Benutzeroberflächenmodus und in den TraceListener Instanzen in der Listeners Auflistung ausgeführt wird.

Hinweis

Die Anzeige des Meldungsfelds hängt vom Vorhandensein der DefaultTraceListenerMeldung ab. Wenn sich die DefaultTraceListenerListeners Auflistung nicht befindet, wird das Meldungsfeld nicht angezeigt. Dies DefaultTraceListener kann durch das <Löschen>, das <Entfernen> 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 eine TraceListener der Auflistung hinzufügen oder aus dieser Listeners entfernen.

Weitere Informationen

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