Export (0) Print
Expand All

TraceSwitch.TraceError Property

Gets a value indicating whether the Level is set to Error, Warning, Info, or Verbose.

[Visual Basic]
Public ReadOnly Property TraceError As Boolean
[C#]
public bool TraceError {get;}
[C++]
public: __property bool get_TraceError();
[JScript]
public function get TraceError() : Boolean;

Property Value

true if the Level is set to Error, Warning, Info, or Verbose; otherwise, false.

Remarks

You can use the TraceError, TraceWarning, TraceInfo, and TraceVerbose properties in conjunction with the Debug and Trace classes to output all messages with a specified importance or greater. When the Level is set to the highest importance, Error, only error-handling messages are output.

Example

[Visual Basic, C#, C++] The following example creates a new TraceSwitch and uses the switch to determine whether to print error messages. The switch is created at the class level. MyMethod will write the first error message if the Level is set to TraceError or higher. However, MyMethod will not write the second error message when the Level is less than TraceVerbose.

[Visual Basic] 
' Class-level declaration.
' Create a TraceSwitch to use in the entire application. 
Private Shared mySwitch As New TraceSwitch("General", "Entire Application")    

Public Shared Sub MyMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If mySwitch.TraceError Then
        Console.WriteLine("My error message.")
    End If 
    ' Write the message if the TraceSwitch level is set to Verbose.
    If mySwitch.TraceVerbose Then
        Console.WriteLine("My second error message.")
    End If
End Sub

Public Shared Sub Main()
    ' Run the method that prints error messages based on the switch level.
    MyMethod()
End Sub


[C#] 
//Class-level declaration.
 /* Create a TraceSwitch to use in the entire application.*/
 static TraceSwitch mySwitch = new TraceSwitch("General", "Entire Application");
 
 static public void MyMethod() {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(mySwitch.TraceError)
       Console.WriteLine("My error message.");
 
    // Write the message if the TraceSwitch level is set to Verbose.
    if(mySwitch.TraceVerbose)
       Console.WriteLine("My second error message.");
 }
 
 public static void Main(string[] args) {
    // Run the method that prints error messages based on the switch level.
    MyMethod();
 }
 

[C++] 
//Class-level declaration.
 /* Create a TraceSwitch to use in the entire application.*/
 static TraceSwitch* mySwitch = new TraceSwitch(S"General", S"Entire Application");
 
public:
 static void MyMethod() {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(mySwitch->TraceError)
       Console::WriteLine(S"My error message.");
 
    // Write the message if the TraceSwitch level is set to Verbose.
    if(mySwitch->TraceVerbose)
       Console::WriteLine(S"My second error message.");
 }
 
 static void main() {
    // Run the method that prints error messages based on the switch level.
    MyMethod();
 }
 

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

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

TraceSwitch Class | TraceSwitch Members | System.Diagnostics Namespace | TraceSwitch | Switch | TraceLevel | Debug | Trace

Show:
© 2014 Microsoft