读书人

log4net应用详解

发布时间: 2012-11-10 10:48:51 作者: rapoo

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应用详解
控制台上的输出

log4net应用详解
日志文件内容

?

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

读书人网 >编程

热点推荐