C# 利用Log4Net进行日志记录

概述

本文主要简单说明如何使用Log4Net进行日志记录，在程序开发过程中记录日志的优点：

它可以提供应用程序运行时的精确环境，可供开发人员尽快找到应用程序中的Bug；

一旦在程序中加入了Log 输出代码，程序运行过程中就能生成并输出日志信息而无需人工干预。

日志信息可以输出到不同的地方（控制台，文件等）以备以后研究之用。

关于Log4Net的官方说明：

The Apache log4net library is a tool to help the programmer output log statements to a variety of output targets. log4net is a port of the excellent Apache log4j™ framework to the Microsoft® .NET runtime. We have kept the framework similar in spirit to the original log4j while taking advantage of new features in the.NET runtime。

【粗略翻译】Apache log4net 类库是一个帮助程序员输出日志状态到多种目标平台。log4net 是优秀的 Apache log4jTM 框架在微软.Net平台的一个实现。在保持原有log4j的思想的前提下，同时利用.Net的新特性。

Log4Net 在程序中使用，可以通过配置文件，进行配置，也可以通过程序代码进行定义。本文主要讲解一下通过配置的方式实现

配置文件结构，如下图所示：

1 <?xml version="1.0" encoding="utf-8" ?>
2 <log4net>
3   <root>
4     <level value="DEBUG" />
5     <appender-ref ref="LogFileAppender" />
6     <appender-ref ref="ConsoleAppender" />
7   </root>
8   <logger name="testApp">
9     <level value="DEBUG" />
10   </logger>
11   <appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
12     <param name="File" value="${TMO}log-file.txt" />
13     <StaticLogFileName value="false"/>
14     <param name="AppendToFile" value="true" />
15     <layout type="log4net.Layout.PatternLayout">
16       <param name="Header" value="[Header]
"/>
17       <param name="Footer" value="[Footer]
"/>
18       <param name="ConversionPattern" value="%d [%t] %-5p %c [%x]  - %m%n"/>
19     </layout>
20     <filter type="log4net.Filter.LevelRangeFilter">
21       <param name="LevelMin" value="DEBUG" />
22       <param name="LevelMax" value="ERROR" />
23     </filter>
24   </appender>
25   <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" >
26     <layout type="log4net.Layout.PatternLayout">
27       <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
28     </layout>
29   </appender>
30 </log4net>

View Code

附加：

如何设置环境变量：

System.Environment.SetEnvironmentVariable("TMO", DateTime.Now.ToString("yyyyMMdd"));

日志记录优先级如下表所示：

级别	允许的方法	Boolean属性	优先级别
OFF			Highest
FATAL	void Fatal(...);	bool IsFatalEnabled;
RROR	void Error(...);	bool IsErrorEnabled;
WARN	void Warn(...);	bool IsWarnEnabled;
INFO	void Info(...);	bool IsInfoEnabled;
DEBUG	void Debug(...);	bool IsDebugEnabled;
ALL			Lowest

备注：

log4net确实是一个应用广泛且简单好用的日志记录框架，本文只是简单的说明，后续工作中会继续研究其他的功能