DefaultTraceListener.Fail Method (String, String)

 

Emits or displays detailed messages and a stack trace for an assertion that always fails.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

public override void Fail(
	string message,
	string detailMessage
)

Parameters

message
Type: System.String

The message to emit or display.

detailMessage
Type: System.String

The detailed message to emit or display.

By default, this method sends the message parameter, the detailMessage parameter, and a stack trace to a message box (when the application runs in user-interface mode) and to the DefaultTraceListener instance.

The following code example calls a function that calls the Fail(String, String) method to log a detailed error message if the function throws an exception. The method writes the message to the console if a user interface is not available.

// 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;
}

.NET Framework
Available since 1.1
Return to top
Show: