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    
  /// </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"的情况,希望大家注意。 

原文地址:https://www.cnblogs.com/tanbin1766/p/3157440.html