Log4net详细说明使用

1、概述 log4net是.Net下一个非常优秀的开源日志记录组件。log4net记录日志的功能非常强大。它可以将日志分不同的等级，以不同的格式，输出到不同的媒介。本文主要是介绍如何在Visual Studio2008中使用log4net快速创建系统日志，如何扩展以输出自定义字段。 2、一个简单的使用实例 第一步：在项目中添加对log4net.dll的引用，这里引用版本是1.2.10.0。 第二步：程序启动时读取log4net的配置文件。 如果是CS程序，在根目录的Program.cs中的Main方法中添加： log4net.Config.XmlConfigurator.Configure(); 如果是BS程序，在根目录的Global.asax.cs（没有新建一个）中的Application_Start方法中添加： log4net.Config.XmlConfigurator.Configure(); 无论BS还是CS程序都可直接在项目的AssemblyInfo.cs文件里添加以下的语句： [assembly: log4net.Config .XmlConfigurator()] 也可以使用自定义的配置文件，具体请参见4.4 关联配置文件。 第三步：修改配置文件。如果是CS程序，则在默认的App.config文件（没有新建一个）中添加内容；如果是BS程序，则添加到Web.config文件中，添加内容一样，这里不再列出。 App.config文件添加内容如下： &lt;?xml version="1.0" encoding="utf-8" ?&gt; <configuration> <configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" /> </configSections> <log4net> <root> <level value="WARN" /> <appender-ref ref="LogFileAppender" /> <appender-ref ref="ConsoleAppender" /> </root> <logger name="testApp.Logging"> <level value="DEBUG"/> </logger> <appender name="LogFileAppender" type="log4net.Appender.FileAppender" > <param name="File" value="log-file.txt" /> <param name="AppendToFile" value="true" /> <layout type="log4net.Layout.PatternLayout"> <param name="Header" value="[Header] "/> <param name="Footer" value="[Footer] "/> <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" /> </layout> <filter type="log4net.Filter.LevelRangeFilter"> <param name="LevelMin" value="DEBUG" /> <param name="LevelMax" value="WARN" /> </filter> </appender> <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" > <layout type="log4net.Layout.PatternLayout"> <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" /> </layout> </appender> </log4net> </configuration> 第四步：在程序使用。 log4net.ILog log = log4net.LogManager.GetLogger("testApp.Logging");//获取一个日志记录器 log.Info(DateTime.Now.ToString() + ": login success");//写入一条新log 这样就将信息同时输出到控制台和写入到文件名为“log-file.txt”的文件中，其中“log-file.txt”文件的路径是当前程序运行所在目录；也可以定义为绝对路径，配置如： <param name="File" value="C:/log-file.txt" />就写入C盘根目录下log-file.txt文件中 Log4net是一个强大的开源日志记录组件，广泛应用于.NET框架中。它提供了丰富的日志管理功能，能够将日志信息按不同级别分类，并以多种格式输出到不同的目标，如文件、控制台、数据库等。使用Log4net可以方便地监控和调试应用程序，有助于提升软件的可维护性和稳定性。 在Visual Studio 2008中使用Log4net，首先要引入log4net.dll的引用。这可以通过在项目中添加外部引用来完成，确保引用的是1.2.10.0或更高版本。为了在程序启动时初始化log4net配置，需要在相应入口点调用`log4net.Config.XmlConfigurator.Configure()`。对于控制台应用程序，这通常在`Program.cs`的`Main`方法中进行；对于Web应用程序，可以在`Global.asax.cs`的`Application_Start`方法中实现。此外，也可以通过在`AssemblyInfo.cs`文件中添加`[assembly: log4net.Config.XmlConfigurator()]`属性实现自动配置。 配置log4net的核心在于编辑XML配置文件。对于控制台应用，配置信息应添加到`App.config`；对于Web应用，需要将其放入`Web.config`。以下是一个示例配置： ```xml <configuration> <configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" /> </configSections> <log4net> <root> <level value="WARN" /> <appender-ref ref="LogFileAppender" /> <appender-ref ref="ConsoleAppender" /> </root> <logger name="testApp.Logging"> <level value="DEBUG" /> </logger> <appender name="LogFileAppender" type="log4net.Appender.FileAppender"> <param name="File" value="log-file.txt" /> <param name="AppendToFile" value="true" /> <layout type="log4net.Layout.PatternLayout"> <param name="Header" value="[Header] " /> <param name="Footer" value="[Footer] " /> <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" /> </layout> <filter type="log4net.Filter.LevelRangeFilter"> <param name="LevelMin" value="DEBUG" /> <param name="LevelMax" value="WARN" /> </filter> </appender> <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender"> <layout type="log4net.Layout.PatternLayout"> <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" /> </layout> </appender> </log4net> </configuration> ``` 这个配置定义了一个日志级别为`WARN`的根日志器，将日志输出到控制台和文件。`LogFileAppender`将日志信息写入名为`log-file.txt`的文件，`ConsoleAppender`则将日志输出到控制台。日志格式由`PatternLayout`定义，可以自定义显示内容。`LevelRangeFilter`用于过滤日志级别，只允许`DEBUG`至`WARN`级别的日志通过。 在代码中使用log4net，首先通过`log4net.LogManager.GetLogger("testApp.Logging")`获取一个日志记录器实例，然后调用如`log.Info("message")`的方法来记录信息。在这个例子中，`"testApp.Logging"`是日志器的名称，可以根据需要自定义。 总结起来，Log4net提供了一套灵活的日志管理机制，包括日志级别的设定、多种输出方式、自定义日志格式等功能。通过合理配置和使用，开发者可以在开发过程中有效地追踪和分析问题，提高开发效率和软件质量。在实际项目中，可以根据需求调整配置，例如添加更多的日志记录器、定义不同级别的日志输出策略，以及设置更复杂的过滤规则等。