Apache log4net开源类库 v2.0.6官方最新版

log4net是一个可以帮助程序员把日志信息输出到各种 不同目标的.net类库。它可以容易的加载到开发项目中,实现程序调试和运行的时候的日志信息输出,提供了比.net自己提供的debug类和trace 类的功能更多。log4net是从java下有卓越表现的log4j移植过来的。它是apache基金资助的项目的一部分。

官方介绍

log4net 框架是基于 Apache log4j™，关于 log4j 的更多信息查看 http://logging.apache.org/log4j/。

本文介绍 log4net API，其独特的功能和设计原理。log4net 是一个基于很多作者的工作的开源项目。log4net 允许开发人员用任意粒度控制日志语句的输出。log4net 使用外部配置文件在运行时完全可配置。

几乎每个大型应用程序都包含它自己的日志，或追踪 API。向代码中插入日志语句对于调试程序是一个很低级的方法。这也是唯一一个方法，因为调试器不会总是可靠或可用的。通常是在大规模多线程应用程序和分布式应用程序的情况。

应用程序一旦被部署，使用开发或调试工具将不是不可能的。一个管理员可以使用有效的日志系统来诊断和修复很多配置问题。

经验说明，日志是一个开发周期中很重要的组件。它提供了很多优势。如提供关于应用程序执行的准确的上下文环境（context ）。日志一旦插入到代码，日志输出的产生不需要人工干预。此外，日志输出可以保存在永久介质，以在稍后进行研究。除了用在开发周期中，丰富的日志记录包也可以被看作一个审计工具。

日志确实也有它的缺点。它可以减慢应用程序。如果太详细，它可能会导致滚动失败。为缓解这些问题，log4net 被设计成可靠的，快速的和可扩展的。由于日志很少是一个应用程序的主要焦点，因此，log4net API 致力于易于理解和使用。

log4net配置详解

第一步：配置config文件

为了方便管理，把log4net的配置文件从web.config中分离，新建一个名为log4net.config的文件，内容如下：

更新日志

Apache log4net从 2.0.6 开始，.NET Core — 或更准确地说是 .NET Standard 1.3 — 已经成为一个支持的平台。请注意，使用 .NET Core 版本时，log4net 的几个功能不可用，特别是 .NET 标准的程序集不支持以下功能：

1、the ADO.NET appender

2、anything related to ASP.NET (trace appender and several pattern converters)

3、.NET Remoting

4、log4net.LogicalThreadContext and the associated properties and stack classes

5、the colored console appender

6、the event log appender

7、The NetSendAppender

8、The SMTP appender

9、DOMConfigurator

10、stack trace patterns

11、access to appSettings (neither the log4net section itself nor using the AppSettingsPatternConverter)

12、Access to "special paths" using the EnvironmentFolderPathPatternConverter

13、Impersonation of Windows accounts

更新内容

Bug 修复

1、[LOG4NET-508] - NAnt release build is not optimized

2、[LOG4NET-512] - Thread safety issue in Hierarchy.cs

3、[LOG4NET-527] - broken link on config-examples.html

4、[LOG4NET-529] - Possible thread-safety bug in LoggingEvent

5、[LOG4NET-536] - Can't build for NETCF-2.0

改进

1、[LOG4NET-530] - Use UTC internally to avoid ambiguous timestamps

新特性

1、[LOG4NET-467] - Is .NET Core, will be supported in the near future, or not

2、[LOG4NET-511] - API to flush appenders

3、[LOG4NET-526] - Add appSetting conversion pattern to PatternString-->-->-->