DefaultTraceListener.Fail Method (String, String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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


Type: System.String

The message to emit or display.

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.
    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);

.NET Framework
Available since 1.1
Return to top