1. 程式人生 > >log4net使用詳解

log4net使用詳解

exce mmd 啟用 evel b- 錯誤日誌 lin nag 信息

說明:本程序演示如何利用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使用詳解(續)》。

log4net使用詳解