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-->-->-->