log4net使用具体解释

说明:本程序演示怎样利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。利用log4net能够方便地将日志信息记录到文件、控制台、Windows事件日志和数据库(包含MS SQL Server, Access, Oracle9i,Oracle8i,DB2,SQLite)中。而且我们还能够记载控制要记载的日志级别,能够记载的日志类别包含:FATAL(致命错误)、ERROR(一般错误)、WARN(警告)、INFO(一般信息)、DEBUG(调试信息)。要想获取最新版本号的log4net组件库,能够到官方站点http://logging.apache.org/log4net/下载。如今的最新版本号是1.2.10。

以下的样例展示了怎样利用log4net记录日志 。

首先从官方站点下载近期版本号的log4net组件,如今的最新版本号是1.2.10。在程序中我们仅仅须要log4net.dll文件即可了,加入�对log4net.dll的引用,就能够在程序中使用了。

接着我们配置相关的配置文件(WinForm相应的是*.exe.config,WebForm相应的是*.config),本实例中是控制台应用程序,配置例如以下(附各配置的说明):

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  
<configSections>
    
<section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
  
</configSections>
  
<appSettings>
  
</appSettings>
  
<log4net>
    
<!--定义输出到文件里-->
    
<appender name="LogFileAppender" type="log4net.Appender.FileAppender">
      
<!--定义文件存放位置-->
      
<file value="D:/log4netfile.txt" />
      
<appendToFile value="true" />
      
<rollingStyle value="Date" />
      
<datePattern value="yyyyMMdd-HH:mm:ss" />
      
<layout type="log4net.Layout.PatternLayout">
        
<!--每条日志末尾的文字说明-->
        
<footer value="by 周公" />
        
<!--输出格式-->
        
<!--例子:2008-03-26 13:42:32,111 [10] INFO  Log4NetDemo.MainClass [(null)] - info-->
        
<conversionPattern value="记录时间:%date 线程ID:[%thread] 日志级别:%-5level 出错类:%logger property:[%property{NDC}] - 错误描写叙述:%message%newline" />
      
</layout>
    
</appender>
    
<!--定义输出到控制台命令行中-->
    
<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
      
<layout type="log4net.Layout.PatternLayout">
        
<conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
      
</layout>
    
</appender>
    
<!--定义输出到windows事件中-->
    
<appender name="EventLogAppender" type="log4net.Appender.EventLogAppender">
      
<layout type="log4net.Layout.PatternLayout">
        
<conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
      
</layout>
    
</appender>
    
<!--定义输出到数据库中,这里举例输出到Access数据库中,数据库为C盘的log4net.mdb-->
    
<appender name="AdoNetAppender_Access" type="log4net.Appender.AdoNetAppender">
      
<connectionString value="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:log4net.mdb" />
      
<commandText value="INSERT INTO LogDetails ([LogDate],[Thread],[Level],[Logger],[Message]) VALUES (@logDate, @thread, @logLevel, @logger,@message)" />
      
<!--定义各个參数-->
      
<parameter>
        
<parameterName value="@logDate" />
        
<dbType value="String" />
        
<size value="240" />
        
<layout type="log4net.Layout.PatternLayout">
          
<conversionPattern value="%date" />
        
</layout>
      
</parameter>
      
<parameter>
        
<parameterName value="@thread" />
        
<dbType value="String" />
        
<size value="240" />
        
<layout type="log4net.Layout.PatternLayout">
          
<conversionPattern value="%thread" />
        
</layout>
      
</parameter>
      
<parameter>
        
<parameterName value="@logLevel" />
        
<dbType value="String" />
        
<size value="240" />
        
<layout type="log4net.Layout.PatternLayout">
          
<conversionPattern value="%level" />
        
</layout>
      
</parameter>
      
<parameter>
        
<parameterName value="@logger" />
        
<dbType value="String" />
        
<size value="240" />
        
<layout type="log4net.Layout.PatternLayout">
          
<conversionPattern value="%logger" />
        
</layout>
      
</parameter>
      
<parameter>
        
<parameterName value="@message" />
        
<dbType value="String" />
        
<size value="240" />
        
<layout type="log4net.Layout.PatternLayout">
          
<conversionPattern value="%message" />
        
</layout>
      
</parameter>
    
</appender>
    
<!--定义日志的输出媒介,以下定义日志以四种方式输出。也能够以下的依照一种类型或其它类型输出。-->
    
<root>
      
<!--文件形式记录日志-->
      
<appender-ref ref="LogFileAppender" />
      
<!--控制台控制显示日志-->
      
<appender-ref ref="ConsoleAppender" />
      
<!--Windows事件日志-->
      
<appender-ref ref="EventLogAppender" />
      
<!-- 假设不启用对应的日志记录,能够通过这样的方式凝视掉
      <appender-ref ref="AdoNetAppender_Access" />
      
-->
    
</root>
    
  
</log4net>
</configuration>

程序文件:

using System;
using System.Collections.Generic;
using System.Text;
using System.Windows.Forms;
using System.Reflection;
using log4net;

//注意以下的语句一定要加上,指定log4net使用.config文件来读取配置信息
//假设是WinForm(假定程序为MyDemo.exe,则须要一个MyDemo.exe.config文件)
//假设是WebForm,则从web.config中读取相关信息
[assembly: log4net.Config.XmlConfigurator(Watch = true)]
namespace Log4NetDemo
{
    
/// <summary>
    
/// 说明:本程序演示怎样利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。
    
/// 利用log4net能够方便地将日志信息记录到文件、控制台、Windows事件日志和数据库中(包含MS SQL Server, Access, Oracle9i,Oracle8i,DB2,SQLite)。
    
/// 以下的样例展示了怎样利用log4net记录日志
    
/// 作者:周公
    
/// 时间:2008-3-26
    
/// 首发地址:http://blog.csdn.net/zhoufoxcn/archive/2008/03/26/2220533.aspx
    
/// </summary>
    public class MainClass
    {
        
public static void Main(string[] args)
        {
            
//Application.Run(new MainForm());
            
//创建日志记录组件实例
            ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
            
//记录错误日志
            log.Error("error",new Exception("发生了一个异常"));
            
//记录严重错误
            log.Fatal("fatal",new Exception("发生了一个致命错误"));
            
//记录一般信息
            log.Info("info");
            
//记录调试信息
            log.Debug("debug");
            
//记录警告信息
            log.Warn("warn");
            Console.WriteLine(
"日志记录完成。");
            Console.Read();
        }
    }
}

执行结果:

控制台上的输出


日志文件内容

 

在这里须要特别说明一下,注意上面的代码中有这么一句:[assembly: log4net.Config.XmlConfigurator(Watch = true)](在须要使用log4net的类的namespace处),假设没有这句就会在调试时得到例如以下留言中所说的“程序调试起来时isDebugEnable"的情况,希望大家注意。 

关于未尽之处,请看周公对以下读者的一些问题的答复《Log4Net使用具体解释(续)》

posted @ 2014-09-09 13:04  hrhguanli  阅读(238)  评论(0编辑  收藏  举报