DefaultTraceListener.Fail Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Gibt eine Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.

Überlädt

Fail(String)	Gibt eine Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.
Fail(String, String)	Gibt eine detaillierte Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.

Fail(String)

Quelle:

DefaultTraceListener.cs

Gibt eine Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.

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

public override void Fail (string? message);

override this.Fail : string -> unit

Public Overrides Sub Fail (message As String)

Parameter

message

String

Die auszugebende oder anzuzeigende Meldung.

Beispiele

Im folgenden Codebeispiel wird mithilfe der Fail(String) -Methode eine Fehlermeldung in ein DefaultTraceListener geschrieben. Die -Methode schreibt die Nachricht auch in die Konsole, wenn keine Benutzeroberfläche verfügbar ist.

// Report that the required argument is not present.
const string ENTER_PARAM = "Enter the number of " +
          "possibilities as a command line argument.";
defaultListener.Fail(ENTER_PARAM);
if (!defaultListener.AssertUiEnabled)
{
    Console.WriteLine(ENTER_PARAM);
}

' Report that the required argument is not present.
Const ENTER_PARAM As String = "Enter the number of " & _
    "possibilities as a command line argument."
defaultListener.Fail(ENTER_PARAM)
If Not defaultListener.AssertUiEnabled Then
    Console.WriteLine(ENTER_PARAM)
End If

Hinweise

Standardmäßig sendet diese Methode den message Parameter und eine Stapelablaufverfolgung an ein Meldungsfeld (wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird) und an den DefaultTraceListener instance.

Weitere Informationen

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• TextWriterTraceListener
• Debug
• Trace

Fail(String, String)

Quelle:

DefaultTraceListener.cs

Gibt eine detaillierte Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.

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

public override void Fail (string? message, string? detailMessage);

override this.Fail : string * string -> unit

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

Parameter

message

String

Die auszugebende oder anzuzeigende Meldung.

detailMessage

String

Die detaillierte Meldung, die ausgegeben oder angezeigt werden soll.

Beispiele

Im folgenden Codebeispiel wird eine Funktion aufgerufen, die die Fail(String, String) -Methode aufruft, um eine detaillierte Fehlermeldung zu protokollieren, wenn die Funktion eine Ausnahme auslöst. Die -Methode schreibt die Nachricht in die Konsole, wenn keine Benutzeroberfläche verfügbar ist.

// Compute the next binomial coefficient and handle all exceptions.
try
{
    result = CalcBinomial(possibilities, iter);
}
catch(Exception ex)
{
    string failMessage = String.Format("An exception was raised when " +
        "calculating Binomial( {0}, {1} ).", possibilities, iter);
    defaultListener.Fail(failMessage, ex.Message);
    if (!defaultListener.AssertUiEnabled)
    {
        Console.WriteLine(failMessage+ "\n" +ex.Message);
    }
    return;
}

' Compute the next binomial coefficient and handle all exceptions.
Try
    result = CalcBinomial(possibilities, iter)
Catch ex As Exception
    Dim failMessage As String = String.Format( _
            "An exception was raised when " & _
            "calculating Binomial( {0}, {1} ).", _
            possibilities, iter)
    defaultListener.Fail(failmessage, ex.Message)
    If Not defaultListener.AssertUiEnabled Then
        Console.WriteLine(failMessage & vbCrLf & ex.Message)
    End If
    Return
End Try

Hinweise

Standardmäßig sendet diese Methode den message Parameter, den detailMessage Parameter und eine Stapelablaufverfolgung an ein Meldungsfeld (wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird) und an den DefaultTraceListener instance.

Weitere Informationen

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• TextWriterTraceListener
• Debug
• Trace