一、介紹
log4net庫是Apache log4j框架在Microsoft .NET平臺的實現,是一個幫助程序員將日誌信息輸出到各種目標(控制檯、文件、數據庫等)的工具。
log4net是Apache軟件基金會Apache Logging Services工程的一部分。Apache日誌服務工程致力於爲程序調試和審計提供跨語言的日誌服務。支持多數框架,可輸出日誌到多種目標,層級日誌體系,可使用XML配置,可動態配置,記錄上下文信息,被檢驗過的體系,模塊化和可擴展化設計,靈活、高性能。
log4net有5個日誌級別:
1.Debug:調試級別信息。
2.Info:一般信息。
3.Warn:警告信息。
4.Error:錯誤信息。
5.Fatal:致命錯誤。
二、簡單應用
1.添加引用
通過網絡下載或nuget安裝,得到log4net.dll,添加到項目中引用。
2.在web.config中或新建log4net.config配置日誌
<log4net>
<!--數據日誌-->
<appender name="InfoRollingFileAppender" type="log4net.Appender.RollingFileAppender">
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<param name="File" value="Log\Info\" />
<param name="AppendToFile" value="true" />
<param name="rollingStyle" value="Date" />
<param name="datePattern" value="yyyy-MM-dd.'Info.log'" />
<param name="staticLogFileName" value="false" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%n%n%n 記錄時間:%date %n日誌級別: %-5level %n出錯類:%logger %n錯誤描述:%message %newline%newline" />
</layout>
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="INFO" />
<param name="LevelMax" value="INFO" />
</filter>
</appender>
<!--錯誤日誌-->
<appender name="ErrorRollingFileAppender" type="log4net.Appender.RollingFileAppender">
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<param name="File" value="Log\Error\" />
<param name="AppendToFile" value="true" />
<param name="rollingStyle" value="Date" />
<param name="datePattern" value="yyyy-MM-dd.'error.log'" />
<param name="staticLogFileName" value="false" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%n%n%n 記錄時間:%date %n日誌級別: %-5level %n出錯類:%logger %n錯誤描述:%message %newline%newline" />
</layout>
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="ERROR" />
<param name="LevelMax" value="ERROR" />
</filter>
</appender>
<!--調試日誌-->
<appender name="DebugRollingFileAppender" type="log4net.Appender.RollingFileAppender">
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<param name="File" value="Log\Debug\" />
<param name="AppendToFile" value="true" />
<param name="rollingStyle" value="Date" />
<param name="datePattern" value="yyyy-MM-dd.'debug.log'" />
<param name="staticLogFileName" value="false" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%n%n%n 記錄時間:%date %n日誌級別: %-5level %n出錯類:%logger %n錯誤描述:%message %newline%newline" />
</layout>
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="DEBUG" />
<param name="LevelMax" value="DEBUG" />
</filter>
</appender>
<root>
<level value="DEBUG" />
<!--文件形式記錄日誌-->
<appender-ref ref="ErrorRollingFileAppender" />
<appender-ref ref="DebugRollingFileAppender" />
<appender-ref ref="InfoRollingFileAppender" />
</root>
</log4net>
3.創建日誌類
[assembly: log4net.Config.XmlConfigurator(Watch = true)]
namespace Test.Core
{
public class Log
{
/// <summary>
/// 一般錯誤
/// </summary>
/// <param name="message">消息</param>
public static void Error(object message)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Error(message);
}
catch
{
}
}
/// <summary>
/// 一般錯誤
/// </summary>
/// <param name="message">消息</param>
/// <param name="exception">異常</param>
public static void Error(object message, Exception exception)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Error(message, exception);
}
catch
{
}
}
/// <summary>
/// 信息
/// </summary>
/// <param name="message">消息</param>
public static void Info(object message)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Info(message);
}
catch
{
}
}
/// <summary>
/// 信息
/// </summary>
/// <param name="message">消息</param>
/// <param name="exception">異常</param>
public static void Info(object message, Exception ex)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Info(message, ex);
}
catch
{
}
}
/// <summary>
/// 警告
/// </summary>
/// <param name="message">消息</param>
public static void Warn(object message)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Warn(message);
}
catch
{
}
}
/// <summary>
/// 警告
/// </summary>
/// <param name="message">消息</param>
/// <param name="exception">異常</param>
public static void Warn(object message, Exception ex)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Warn(message, ex);
}
catch
{
}
}
/// <summary>
/// 調試
/// </summary>
/// <param name="message">消息</param>
public static void Debug(object message)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Debug(message);
}
catch
{
}
}
/// <summary>
/// 調試
/// </summary>
/// <param name="message">消息</param>
/// <param name="exception">異常</param>
public static void Debug(object message, Exception ex)
{
try
{
log4net.ILog log = log4net.LogManager.GetLogger(GetCurrentMethodFullName());
log.Debug(message, ex);
}
catch
{ }
}
/// <summary>
/// 獲取執行的方法名稱
/// </summary>
/// <returns></returns>
static string GetCurrentMethodFullName()
{
try
{
int depth = 2;
System.Diagnostics.StackTrace st = new System.Diagnostics.StackTrace();
int maxFrames = st.GetFrames().Length;
System.Diagnostics.StackFrame sf;
string methodName, className;
Type classType;
do
{
sf = st.GetFrame(depth++);
classType = sf.GetMethod().DeclaringType;
className = classType.ToString();
} while (className.EndsWith("Exception") && depth < maxFrames);
methodName = sf.GetMethod().Name;
return className + "." + methodName;
}
catch (Exception e)
{
log4net.LogManager.GetLogger("Core.Log").Error(e.Message, e);
return "獲取方法名失敗";
}
}
}
}
4.調用
三、[assembly: log4net.Config.XmlConfigurator(Watch = true)]
XmlConfiguratorAttribute有3個屬性:
ConfigFile: 配置文件的名字,文件路徑相對於應用程序目錄(AppDomain.CurrentDomain.BaseDirectory)。ConfigFile屬性不能和ConfigFileExtension屬性一起使用。
ConfigFileExtension: 配置文件的擴展名,文件路徑相對於應用程序的目錄。ConfigFileExtension屬性不能和ConfigFile屬性一起使用。
Watch: 如果將Watch屬性設置爲true,就會監視配置文件。當配置文件發生變化的時候,就會重新加載。
如果ConfigFile和ConfigFileExtension都沒有設置,則使用應用程序的配置文件App.config(Web.config)。