Trace 日志文件

日志，又称为 Log，是我们开发人员的又一利器，其实，不管是在调试还是测试的时候，日志都可以帮助我们解决问题，不过，很多的程序员迷恋于调试器，而忽视了日志。尤其是在测试驱动的开发中，日志更是我们的得力助手。
所谓的日志，其实是一种记录机制，允许我们在程序代码中插入一些特殊的输出代码，将程序当前的运行状态随时输出，以便于在无人值守的情况下记录信息，在事后对程序的处理过程进行分析。

最简单的日志就是直接通过 Console 来输出，或者使用 alert, 或者 MessageBox 来输出，没准你就使用过这些手法。这些方法会给程序带来副作用，在开发完成之后，往往需要你手工删除。不删除的话会造成程序的效率问题。要是又发现有新的问题存在呢？是不是又要再来一遍？这可是开发人员的噩梦呀！

一个完善的日志系统绝不是简单地在控制台输出，它至少需要支持下面的几个特征：

使用一种方式就支持输出到多个目的地，例如：控制台，文本文件，数据库，甚至电子邮件等等。
允许控制输出的级别，过滤输出的内容，而不需要大幅度修改日志程序
使用简单，可以使用简单的语法来记录日志

目前，存在着多个成熟的日志系统供我们选择，在 .NET 开发平台上，主要有两个日志系统：.NET 平台直接支持的日志系统和开源的 Log4Net。

今天，我们先看看 .NET 平台内置的日志系统。

这里我们首先了解三个概念：

日志器：用来发送日志，在开发中，主要是用日志器来输出日志信息。
监听器：日志器用来输出日志信息，日志信息输出到哪里呢? 监听器用来完成实际的日志记录功能，在日志系统中，存在多种监听器，用来将日志信息记录到不同的目的地。
日志控制开关：在软件生命周期的不同阶段，我们需要不同的日志信息，在开发阶段，可能需要比较详细的日志来检查错误，在运行阶段，大部分的问题已经被处理，我们可能仅仅需要记录一些关键信息，通过控制开关，可以在不需要修改代码的情况下，调整日志输出的内容。

在 .NET 中，关于日志处理的相关类型，定义在命名空间 System.Diagnostics 中，有两个预定义的日志器类型，Debug 和 Trace。
这两个日志记录器的工作机制是相同的，区别仅仅在于 Debug 仅仅在编译器定义了 DEBUG 常量的情况下工作，而 Trace 仅仅在定义了 TRACE 常量的情况下工作，默认情况下，当我们使用 Debug 模式编译的时候，默认已经定义了这两个常量。所以，不管使用 Debug 还是 Trace 都可以输出日志信息。如果我们将程序编译为发布模式，那么，将仅仅定义 TRACE 常量，导致忽略 Debug 的存在，只记录 Trace 的日志信息。

我们先看一看监听器，以便能够看到输出的日志信息。
所有的监听器都要从 TraceListener 派生，这是定义在命名空间 System.Diagnostics 中的一个抽象基类。通常我们直接使用系统的一些派生类。

System.Diagnostics.DefaultTraceListener 
System.Diagnostics.Eventing.EventProviderTraceListener 
System.Diagnostics.EventLogTraceListener 
System.Diagnostics.TextWriterTraceListener 
System.Web.WebPageTraceListener

作为文本格式的日志， System.Diagnostics.TextWriterTraceListener 又有几个常用的派生类

System.Diagnostics.ConsoleTraceListener 
System.Diagnostics.DelimitedListTraceListener 
System.Diagnostics.EventSchemaTraceListener 
System.Diagnostics.XmlWriterTraceListener

Debug 和 Trace 使用相同的监听器，默认情况下，在它们的监听器集合属性 Listeners 中，已经添加了一个 System.Diagnostics.DefaultTraceListener 的实例，以便输出到 Visual Studio 的 Output 窗口中，所以，在使用了日志之后，我们可以打开 Output 窗口来看看实际的输出。如果我们希望能够在控制台窗口中看到输出，那么只需要增加一个 ConsoleTraceListener 就可以了。

// 增加一个可以输出到控制台的 Listener 
System.Diagnostics.Trace.Listeners.Add( 
    new System.Diagnostics.ConsoleTraceListener() 
    );

当然，在实际的开发中，我们可能需要的是一个文本文件，现在，你还需要提供一个文件名了。

System.Diagnostics.Trace.Listeners.Add( 
    new System.Diagnostics.TextWriterTraceListener("log.txt") 
    );

这些监听器也可以不在程序中固定声明，而是通过配置文件来更加方便地定义。这样的话，我们就可以动态地修改监听器，而不需要修改我们的代码了。
在程序的配置文件中，配置节 system.diagnostics 用来定义日志的配置参数，其子元素 trace 定义日志的参数，trace 的子元素 listeners 定义日志的监听器。我们可以通过下面的配置参数来增加一个文件的监听器。其中的 initializeData 用来配置文件名。

<add name="fileListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="log.txt" />

当监听器配置好之后，就可以使用日志器输出日志了。不管是 Debug 还是 Trace 都提供了多个方法来输出日志。
最简单的方式就是使用 WriteLine 来输出日志，就跟使用 Console 一样。
不过，对于日志来说，存在的一个问题就是，我们并不总想输出所有的日志，比如程序已经经过测试，我们可能并不需要大量的日志信息来干扰我们，怎么减少实际输出的日志呢？修改程序当然不是一个好主意，我们可以通过条件输出来限制输出的日志内容，仅仅在某种条件下，才输出日志，通过 WriteLineIf ，我们可以指定一个条件，仅仅当条件满足的时候，才会输出日志。

条件仅仅是一个条件，什么样的条件都可以，只要你需要。

为了方便使用，在 .NET 中又提供了一个日志的开关，来方便我们指定条件，所谓日志的开关其实就是一个从 0 到 4 的整数，通过一个枚举 TraceLevel 来方便使用这个整数

0. 关闭，不希望输出日志
1. 错误级别的日志
2. 建议输出错误和警告级别的日志
3. 一般信息的日志也输出
4. 详细日志

不过，实际上输出什么日志还是看你的日志输出语句，你在日志输出语句中可以通过这个开关来判断该不该输出。

那么，这个开关从哪里取得呢？还是配置文件。在配置文件的 system.diagnostics 中，子元素 switches 用来配置一个日志级别，你需要为你的级别起一个名字，以便在程序中

取得这个设置。

<add name="traceSwitch" value="0"/>

在程序中，你可以这样取得配置文件中日志的开关

System.Diagnostics.TraceSwitch myTraceSwitch =

new System.Diagnostics.TraceSwitch("traceSwitch", string.Empty);

在程序中，你可以通过这个开关的设置来决定输出什么，配合开关的级别，在 Trace 中又提供了几个匹配的方法

System.Diagnostics.Trace.TraceError("Error!!!");

System.Diagnostics.Trace.TraceWarning("Warning!!!");

当然，它们仅仅用来输出分类的日志，注意，判断是否输出是你的事情，所以，程序的代码往往如下：

if( myTraceSwitch.TraceError) 
    System.Diagnostics.Trace.TraceError("Error!!!"); 
  
if( myTraceSwitch.TraceWarning) 
    System.Diagnostics.Trace.TraceWarning("Warning!!!");