【原创】.NET中Trace类和Debug类的应用举例

最新推荐文章于 2026-06-17 19:29:23 发布

原创最新推荐文章于 2026-06-17 19:29:23 发布 · 2k 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#.net #class #system #string #warnings

c# 专栏收录该内容

3 篇文章

订阅专栏

本文介绍了.NET框架中Trace和Debug类的基本用法及其应用场景，包括如何利用这两个类进行程序调试、输出信息控制及配置文件设置等。

.NET中Trace类和Debug类的应用举例

（转载请注明出处：http://blog.csdn.net/id_9527）

.NET中的Trace类和Debug类是System.Diagnostics命名空间下的两个用于调试的类，在软件开发中使用得当，可以帮助我们调试开发程序，提高效率，很有用。其中，Debug类仅在调试版本中有效，而Trace类在调试版本和正式版本中均有效。

（1）下面先介绍下Debug类的使用：

Debug类的声明原型：public sealed class Debug

从声明中，我们可以看出，Debug类是无法继承的。它的成员情况，请参见：

http://msdn2.microsoft.com/zh-cn/library/system.diagnostics.debug_members(VS.80).aspx

先看一个例子：

TestDebug.cs：

* User: GoGo

* Date: 2007-12-12

* Email:mingjunliu@163.com

* Blog:http://blog.csdn.net/id_9527

using System;

using System.Collections.Generic;

using System.Text;

using System.Diagnostics; //引入Debug类所在命名空间

namespace traceanddebug

{

class TestDebug

{

public static void TestDebugMethod()

{

Debug.Listeners.Add(new TextWriterTraceListener(Console.Out));

//将Debug类输出定向到控制台输出

Debug.AutoFlush = true;

//设置Debug为自动输出，即每次写入后都调用Listeners上调用Flush

Debug.Indent();

//设置缩进

Debug.WriteLine("Debug WriteLine()");

//用Debug输出"Debug WriteLine()"

Console.WriteLine("Console.WriteLine()");

//用Console输出"Console.WriteLine()"

Debug.WriteLine("Debug WriteLine2()");

//用Debug输出"Debug WriteLine2()"

Debug.Unindent();

//取消缩进

Console.Read();

}

Program.cs

using System;

using System.Collections.Generic;

using System.Text;

namespace traceanddebug

{

class Program

{

static void Main (string[] args)

{

TestDebug.TestDebugMethod();

}

结果显示如下：

Debug WriteLine()

Console.WriteLine()

Debug WriteLine2()

从例子中，我们可以看出，Debug可以向控制台显示信息。需要注意的是，我们在使用Debug时候，需要引入System.Diagnostics命名空间。同样，我们也可以把信息写入文本中，例如，把TestDebug.cs中

Debug.Listeners.Add(new TextWriterTraceListener(Console.Out));

一句修改为：

Debug.Listeners.Add(new TextWriterTraceListener("c://testdebug2.log","testdebug"));

就可以向c盘的根目录下的testdebug2.log文件中写入信息了。

给你留个小问题，你能让debug信息写入windows的事件查看器里面么？

（看看下面的Trace类的例子，也许你就有思路了）

值得注意的是，Debug类的代码在release版本中是无效的，也就是说，所有的Debug类输出语句在发布的时候，是不会输出的，你不用特意删除Debug类的代码，就能给用户一个没有调试语句的程序了。这个用起来是不是很方便呢？

Debug类除了输出信息之外，还有一个静态成员函数很有用，就是Debug.Assert方法。它有三种重载形式：

Debug.Assert(Boolean)

Debug.Assert(Boolean, String)

它的作用为：检查条件，如果该条件为 false，则显示消息。此函数会显示相关堆栈信息。

例如，我们在上面的TestDebug.cs中TestDebugMethod函数中加入一下语句：

Debug.Assert(false,"test assert");

那么运行时，就会停在Debug.Assert调用的地方，弹出一个对话框，显示信息及堆栈信息。我们在实际应用的时候，需要讲例子中的false换成条件判断，如果不满足条件，就会停止。

（2）下面介绍Trace类的使用：

Trace类的声明原型为：public sealed class Trace，其成员情况，请参加网址：

http://msdn2.microsoft.com/zh-cn/library/system.diagnostics.trace_members(VS.80).aspx

同样，我们先从小例子来认识Trace类：

TestTrace.cs

* User: GoGo

* Date: 2007-12-12

* Email:mingjunliu@163.com

* Blog:http://blog.csdn.net/id_9527

using System;

using System.Diagnostics;

namespace traceanddebug

{

public class TestTrace

{

public static void TheTrace()

{

Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));

Trace.WriteLine("Trace !!!");

Console.ReadKey();

}

Program.cs

using System;

using System.Collections.Generic;

using System.Text;

namespace traceanddebug

{

class Program

{

static void Main (string[] args)

{

TestTrace.TheTrace();

}

编译运行程序，输出结果如下：

Trace !!!

从这个例子中，我们可以看出，Trace类可以像Debug类一样输出信息到控制台。同样，Trace类可以设置输出定向到文本文件或者日志中。可以添加一下代码测试：

Trace.Listeners.Add(new TextWriterTraceListener("testtrace.log"));

Trace.Listeners.Add(new EventLogTraceListener("testtrace"));

Trace.AutoFlush = true;

这样就同时把Trace!!这个字符串写入testtrace.log文件和事件查看器中应用程序里面了。

除了在程序中设定信息输出位置外，还可以在配置文件中设定跟踪调试信息的输出位置。默认是在控制台输出。我们可以通过添加配置参数，修改输出位置。例如：

假设我们的运行程序为traceanddebug.exe，我们在相同目录下建立traceanddebug.exe.config配置文件，输入如下内容：

<system.diagnostics>

</add>

</listeners>

</trace>

</system.diagnostics>

</configuration>

这样我们可以修改程序TheTrace()为：

//Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));

Trace.WriteLine("Trace !!!");

Console.ReadKey();

这样就可以把结果直接写入事件查看器中。

由于Trace类可以在发布版本中起作用，所以，在做Trace输出信息的时候，可能有些信息是调试的时候需要，发布的时候又不需要了，那怎么才能保证信息不在发布的时候输出呢？.NET为我们提供了五个控制Trace的跟踪级别，使用它们不必重新编译，他们跟别是：

Trace Level	Value	显示（或写入指定输出目标）的消息类型
Off	0	无，即关闭显示信息
Errors	1	仅限错误信息
Warnings	2	警告消息和错误信息
Info	3	提示信息、警告消息和错误信息
Verbose	4	详细消息、提示性消息、警告消息和错误信息