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();
        }
    }
}

运行结果:
log4net使用详解 ._第1张图片
控制台上的输出

log4net使用详解 ._第2张图片
日志文件内容

 

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

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

 

注意要加上: log4net.Config.XmlConfigurator.Configure(new FileInfo(Application.StartupPath + @"\log4net.config"));

你可能感兴趣的:(thread,数据库,assembly,webform,WinForm,log4net)