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 log4j^TM框架在微软.Net平台的一个实现。在保持原有log4j的思想的前提下，同时利用.Net的新特性。

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

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

配置文件可以配置在App.config中【编译后会生成对应的[程序名].exe.config】，也可以配置在独立的xml文件中。

如果配置在独立的xml文件中，需要在Assembly.cs中增加一句说明，如下所示：

[assembly: log4net.Config.DOMConfigurator(ConfigFile = "Log4NetConfig.xml",ConfigFileExtension = "xml",Watch = true)]

如果配置在App.config中，除了配置log4net节点外，还要对节点进行声明，即要增加configSection节点【放在根节点的第一个元素】，如下所示

生成的日志文件内容，如下图所示：

核心代码

代码如下：

 1 using log4net;
 2  System;
 3  System.Collections.Generic;
 4  System.Linq;
 5  System.Text;
 6  System.Threading.Tasks;
 7 
 8 [assembly: log4net.Config.XmlConfigurator(Watch = true)]
 9 namespace DemoLog4Net
10 {
11     /// <summary>
12     /// 日志记录
13     </summary>
14     public class LogHelper
15     {
16         17          日志实例
18         19         private static ILog logInstance=LogManager.GetLogger("testApp");
20 
21         static void WriteLog(string message,LogLevel level) {
22             switch (level) {
23                 case LogLevel.Debug:
24                     logInstance.Debug(message);
25                     break;
26                  LogLevel.Error:
27                     logInstance.Error(message);
28                     29                  LogLevel.Fatal:
30                     logInstance.Fatal(message);
31                     32                  LogLevel.Info:
33                     logInstance.Info(message);
34                     35                  LogLevel.Warn:
36                     logInstance.Warn(message);
37                     38                 default:
39 40                     41             }
42         }
43     }
44 
45     enum LogLevel {
46         Debug=0,47         Error=148         Fatal=249         Info=350         Warn=4
51 52 }

View Code

独立配置文件如下：

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

View Code

附加：

如何设置环境变量：

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

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

@H_756_502@

级别	允许的方法	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确实是一个应用广泛且简单好用的日志记录框架，本文只是简单的说明，后续工作中会继续研究其他的功能

C# 利用Log4Net进行日志记录

相关推荐