Emits an error message.

Overload List

Emits the specified error message.

[Visual Basic] Overloads Public Shared Sub Fail(String)

[C#] public static void Fail(string);

[C++] public: static void Fail(String*);

[JScript] public static function Fail(String);

Emits an error message, and a detailed error message.

[Visual Basic] Overloads Public Shared Sub Fail(String, String)

[C#] public static void Fail(string, string);

[C++] public: static void Fail(String*, String*);

[JScript] public static function Fail(String, String);

Example

[Visual Basic, C#, JScript] The following example uses the Fail method to print a message during exception handling.

[Visual Basic, C#, JScript] Note   This example shows how to use one of the overloaded versions of Fail. For other examples that might be available, see the individual overload topics.

[Visual Basic] 
Catch
    Trace.Fail("Invalid value: " & value.ToString(), _
        "Resetting value to newValue.")
    value = newValue
End Try

[C#] 
catch (Exception) {
    Trace.Fail("Invalid value: " + value.ToString(), 
       "Resetting value to newValue.");
    value = newValue;
}

[JScript] 
}catch(e : Exception){
    Trace.Fail("Invalid value: " + value.ToString(), "Resetting value to newValue.")
    value = newValue
}

[Visual Basic, C#, JScript] You can also use the Fail method in a switch statement.

[Visual Basic] 
Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

[C#] 
switch (option) {
    case Option.First:
       result = 1.0;
       break;
 
    // Insert additional cases.
 
    default:
       Trace.Fail("Unknown Option " + option, "Result set to 1.0");
       result = 1.0;
       break;
}

[JScript] 
switch(option){
  case 1:
    result = 1.0
    break
  // Insert additional cases.
  default:
    Trace.Fail("Unknown option: " + option, "result set to 1.0")
    result = 1.0
}

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button in the upper-left corner of the page.

See Also

Trace Class | Trace Members | System.Diagnostics Namespace