Apache log4net™ 手册——概述【翻译】
原文地址
本文内容配置配置属性应用程序 appSettings配置文件配置语法追加器（Appenders）筛选器（Filters）布局（Layouts）根记录器（Root Logger）记录器（Loggers）渲染（Renderers）参数（Parameters）扩展参数（Extension Parameters）紧凑 Parameter 语法（Compact Parameter Syntax）下载 Demo、log4netApache log4net™ 手册——介绍【翻译】配置向应用程序代码插入日志请求需要大量的规划和努力。观察表明，约 4％ 的代码是专门用来记录日志的。因此，即使中等规模的应用程序也会嵌入成千上万的日志语句。鉴于日志语句在应用程序中的数量，在无需手动修改的情况下，管理这些日志语句，就成为当务之急。
log4net 环境是完全可用编程配置的。然而，利用配置文件来配置 log4net 更灵活。目前，配置文件主要采用xml文件。
下面在 MyApp 应用程序中使用 log4net。
位于本文 Demo 中的 MyApp 演示。
usingCom.Foo;
// Import log4net classes.
usinglog4net;
usinglog4net.Config;
publicclassMyApp
{
// Define a static logger variable so that it references the
// Logger instance named "MyApp".
PRivatestaticreadonlyILog log = LogManager.GetLogger(typeof(MyApp));
staticvoidMain(string[] args)
{
// Set up a simple configuration that logs on the console.
BasicConfigurator.Configure();
log.Info("Enteringapplication.");
Bar bar =newBar();
bar.DoIt();
log.Info("Exiting application.");
}
}
导入 log4net 相关类。然后，定义一个静态的logger变量，用 log4net 静态方法和MyApp类名来初始化。
MyApp 使用位于另一个命令空间中的Bar类：
// Import log4net classes.
usinglog4net;
namespaceCom.Foo
{
publicclassBar
{
privatestaticreadonlyILog log = LogManager.GetLogger(typeof(Bar));
publicvoidDoIt()
{
log.Debug("Did it again!");
}
}
}
调用BasicConfigurator.Configure()方法会创建了一个最简单的 log4net，向 root 记录器添加一个ConsoleAppender——控制台追加器。用log4net.Layout.PatternLayout格式化输出，设置格式为“%-4timestamp [%thread] %-5level %logger %ndc - %message%newline”。
默认时，root记录器被分配为Level.DEBUG。
MyApp 输出为：
0 [main] INFO MyApp - Entering application.
36 [main] DEBUG Com.Foo.Bar - Did it again!
51 [main] INFO MyApp - Exiting application.
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp{ background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }另外，log4net 中的“孩子”记录器只会连接到他们已存在的“祖先”。具体地讲，名为Com.Foo.Bar记录器被直接连接到 root 记录器，从而规避不存在的Com或Com.Foo记录器。这显著提高了性能，并减少 log4net 的内存占用。
MyApp 类通过调用BasicConfigurator.Configure()方法配置 log4net，而无需在配置文件进行任何配置。其他类只需引用 log4net 命名空间，检索期望的记录器就可以。
上面例子总是输出相同的日志信息，但很容易修改 MyApp 的配置，在运行时控制日志的输出。下面稍微对程序进行修改。
位于本文 Demo 中的 MyApp2 演示。
usingCom.Foo;
// Import log4net classes.
usinglog4net;
usinglog4net.Config;
publicclassMyApp
{
privatestaticreadonlyILog log = LogManager.GetLogger(typeof(MyApp));
staticvoidMain(string[] args)
{
// BasicConfigurator replaced with XmlConfigurator.
XmlConfigurator.Configure(newSystem.IO.FileInfo(args[0]));
log.Info("Entering application.");
Bar bar =newBar();
bar.DoIt();
log.Info("Exiting application.");
}
}
XmlConfigurator.Configure()方法可以解析指定的配置文件，并相应地进行设置。上面示例是在命令行参数指定配置文件的路径。
下面配置文件的输出结果跟使用BasicConfigurator的结果一样。
<log4net>
<!-- A1 is set to be a ConsoleAppender -->
<appendername="A1"type="log4net.Appender.ConsoleAppender">
<!-- A1 uses PatternLayout -->
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%-4timestamp [%thread] %-5level %logger %ndc - %message%newline"/>
</layout>
</appender>
<!-- Set root logger level to DEBUG and its only appender to A1 -->
<root>
<levelvalue="DEBUG"/>
<appender-refref="A1"/>
</root>
</log4net>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }假设，我们不想看到任何关于Com.Foo包的输出。下面配置文件是实现这个目标的一种方法。
位于本文 Demo 中的 MyApp3 演示。
<log4net>
<!-- A1 is set to be a ConsoleAppender -->
<appendername="A1"type="log4net.Appender.ConsoleAppender">
<!-- A1 uses PatternLayout -->
<layouttype="log4net.Layout.PatternLayout">
<!-- Print the date in ISO 8601 format -->
<conversionPatternvalue="%date [%thread] %-5level %logger %ndc - %message%newline"/>
</layout>
</appender>
<!-- Set root logger level to DEBUG and its only appender to A1 -->
<root>
<levelvalue="DEBUG"/>
<appender-refref="A1"/>
</root>
<!-- Print only messages of level WARN or above in the package Com.Foo -->
<loggername="Com.Foo">
<levelvalue="WARN"/>
</logger>
</log4net>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }用上面配置文件来配置 MyApp 将显示如下结果：
2000-09-07 14:07:41,508 [main] INFO MyApp - Entering application.
2000-09-07 14:07:41,529 [main] INFO MyApp - Exiting application.
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }由于记录器Com.Foo.Bar在任何地方中没有分配级别，因此，它会从Com.Foo继承，而Com.Foo在配置文件中被设置成WARN级别。因此，Bar.DoIt方法中的记录语句具有 DEBUG 级别，而DEBUG级别比WARN要低。因此，DoIt()方法的日志请求被抑制。
log4net 是按级别输出日志的，只输出从你指定级别高的日志开始。
下面的配置文件使用多个追加器（appenders）。
位于本文 Demo 中的 MyApp4 演示。
<log4net>
<appendername="Console"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<!-- Pattern to output the caller's file name and line number -->
<conversionPatternvalue="%5level [%thread] (%file:%line) - %message%newline"/>
</layout>
</appender>
<appendername="RollingFile"type="log4net.Appender.RollingFileAppender">
<filevalue="example.log"/>
<appendToFilevalue="true"/>
<maximumFileSizevalue="100KB"/>
<maxSizeRollBackupsvalue="2"/>
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%level %thread %logger - %message%newline"/>
</layout>
</appender>
<root>
<levelvalue="DEBUG"/>
<appender-refref="Console"/>
<appender-refref="RollingFile"/>
</root>
</log4net>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }用上面配置文件将输出如下信息到控制台。
INFO [main] (MyApp.cs:16) - Entering application.
DEBUG [main] (Bar.cs:12) - Doing it again!
INFO [main] (MyApp.cs:19) - Exiting application.
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }另外，root记录器的第二个附加目的地，输出还会被定向到example.log文件。当文件达到100KB时，该文件将被转存。转存时，example.log 将自动移动到 example.log.1。
你可以将 100KB 设置得小点，能尽快看到结果。
注意，获得上面那些日志的不同行为，不需要重新编译代码。你可以很容易地登录一个电子邮件地址，重定向所有Com.Foo输出到 NT 事件记录器，或转发事件记录到远程 log4net 服务器，这将根据本地服务器策略日志。
关于使用XmlConfigurator配置追加器的更多例子，查看 Example Appender Configuration 文档。
配置属性log4net 的配置可以通过装配级别（assembly-level）的属性来配置，而不用编程方式。
XmlConfiguratorAttributelog4net.Config.XmlConfiguratorAttribute让XmlConfigurator通过下面属性配置：
ConfigFile如果指定了该属性，XmlConfigurator会使用配置文件名。该配置文件路径是相对应用程序基目录（AppDomain.CurrentDomain.BaseDirectory）。
该属性不能跟下面的ConfigFileExtension属性一起使用。
ConfigFileExtension如果指定了该属性，它就是配置文件的扩展名。装配文件（程序集文件）名作为基文件名，后面加 log4net 配置文件的后缀名。例如，如果装配是从 TestApp.exe 加载的，并且，ConfigFileExtension属性设置为log4net，那么，配置文件的文件名就为TestApp.exe.log4net。这相当于设置ConfigFile属性为TestApp.exe.log4net。
配置文件的路径是应用程序基目录（AppDomain.CurrentDomain.BaseDirectory）。
该属性不能与ConfigFile属性一起使用。
Watch如果该标记指定为true，那么，框架将监控配置文件，并且当配置文件被修改时，重新加载。
如果既ConfigFile和ConfigFileExtension属性都没有指定，那么应用程序配置文件（如TestApp.exe.config）作为 log4net 的配置文件。
用法：
// Configure log4net using the .config file
[assembly: log4net.Config.XmlConfigurator(Watch=true)]
// This will cause log4net to look for a configuration file
// called TestApp.exe.config in the application base
// directory (i.e. the directory containing TestApp.exe)
// The config file will be watched for changes.
// Configure log4net using the .log4net file
[assembly: log4net.Config.XmlConfigurator(ConfigFileExtension="log4net",Watch=true)]
// This will cause log4net to look for a configuration file
// called TestApp.exe.log4net in the application base
// directory (i.e. the directory containing TestApp.exe)
// The config file will be watched for changes.
上面的装配属性只能在装配文件（程序集文件）中出现一次。若出现多次，Build 时，会报错。
Using attributes can be a clearer method for defining where the application's configuration will be loaded from. However it is worth noting that attributes are purely passive. They are information only. Therefore if you use configuration attributes you must invoke log4net to allow it to read the attributes. A simple call to LogManager.GetLogger will cause the attributes on the calling assembly to be read and processed.Therefore it is imperative to make a logging call as early as possible during the application start-up, and certainly before any external assemblies have been loaded and invoked.
应用程序 appSettings如果你使用 attributes 来配置 log4net，你应用程序配置文件的AppSettings小节有两个配置可以用于覆盖你在装配文件中给出的值。
键为 "log4net.Config" 设置，会覆盖配置文件名（相对于你应用程序基目录）；键为 "log4net.Config.Watch" 设置，决定是否监控文件的修改。即使装配文件属性为
[assembly: log4net.Config.XmlConfigurator(Watch=false)]
而你已经配置你的应用程序使用 "TestApp.exe.config" 作为配置文件，并且不监控配置文件的变化。但若把下面配置添加到你的应用程序配置文件，将覆盖这个配置，转而使用 "log4net.config" 作为 log4net 配置文件，并且监控配置文件的变化。
<appSettings>
<addkey="log4net.Config"value="log4net.config"/>
<addkey="log4net.Config.Watch"value="True"/>
</appSettings>
配置文件
使用文件来指定 log4net 配置。有两种方式读取文件：
使用 .NET System.Configuration API直接读取文件内容其实，log4net 即可以读取应用程序 .config 配置文件，也可以直接读取它自己的配置文件。之所以这么做，完全是因为，应用程序访问文件系统时存在权限问题。估计你也遇到和设置过，比如，当在 Web 应用程序中，涉及操作文件系统时，比如写文件，访问所在文件的目录就会遇到权限问题。
.config 文件如果配置的数据是在应用程序配置文件中，如MyApp.exe.config或Web.config，那么 System.Configuration API 是唯一可用的。因为，System.Configuration API 不支持重新加载配置文件，配置的设置不能通过log4net.Config.XmlConfigurator.ConfigureAndWatch方法来监控。使用 System.Configuration API 来读取配置数据的主要优点是，它比直接访问配置文件需要的权限更小。
使用 System.Configuration API 配置应用程序的唯一方法，是调用log4net.Config.XmlConfigurator.Configure()或log4net.Config.XmlConfigurator.Configure(ILoggerRepository)方法。
为了在 .config 文件嵌入配置数据，小节的名称必须能够被 .NET 配置文件分析器识别，这是通过使用configSections元素。小节必须指定log4net.Config.Log4NetConfigurationSectionHandler，用于解析配置的小节。小节的类型必须是完全的装配限定名（fully assembly qualified name），因为，这是通过 .NET 配置文件分析器加载的，而不是 log4net。
对于 log4net 必须指定正确的装配名。下面示例是一个简单的配置，该文件指定了正确的节处理程序用于 log4net。
<?xmlversion="1.0"encoding="utf-8"?>
<configuration>
<configSections>
<sectionname="log4net"type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
</configSections>
<log4net>
<appendername="ConsoleAppender"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
</layout>
</appender>
<root>
<levelvalue="INFO"/>
<appender-refref="ConsoleAppender"/>
</root>
</log4net>
</configuration>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }configSetions元素必须作为configuration元素的第一个子元素。否则，运行应用程序时，会报错。
上面示例，指定了 log4net 程序集（log4net 的 dll 文件）。该程序集必须位于 .NET 运行时能够找到的地方。例如，它位于跟应用程序相同的目录。如果 log4net 程序集被存放在 GAC（全局程序集缓存），那么完全限定的程序集名必须指定文化、版本和公钥。
当使用应用程序 .config 文件指定 log4net 配置时，小节名和 XML 元素必须为log4net，即 XML 文件中 log4net 使用名为“log4net”元素，而setion小节的name属性也为“log4net”。
直接读取文件XmlConfigurator可以直接读取任何 XML 文件来配置 log4net。这包括应用程序 .config 文件，如 MyApp.exe.config 或 Web.config。不直接读取配置文件的唯一理由是，如果应用程序没有足够的权限读取文件，那么，配置必须通过 .NET 配置 API 来加载（见上面）。
通过log4net.Config.XmlConfigurator方法读取配置文件，该方法接受System.IO.FileInfo对象。因为，文件系统可以被监控用于文件修改通知，ConfigureAndWatch方法可用于监控文件的修改，并自动重新配置 log4net。
添加log4net.Config.XmlConfiguratorAttribute用于指定读取的配置文件。
配置可以从文件中的 log4net 元素读取。在文件中，只能指定一个 log4net 元素，但它可以位于 XML 结构中的任何位置。例如，它可以是根元素：
<?xmlversion="1.0"encoding="utf-8"?>
<log4net>
<appendername="ConsoleAppender"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
</layout>
</appender>
<root>
<levelvalue="INFO"/>
<appender-refref="ConsoleAppender"/>
</root>
</log4net>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }或是，嵌入其他元素内：
<?xmlversion="1.0"encoding="utf-8"?>
<configuration>
<configSections>
<sectionname="log4net"type="System.Configuration.IgnoreSectionHandler"/>
</configSections>
<log4net>
<appendername="ConsoleAppender"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
</layout>
</appender>
<root>
<levelvalue="INFO"/>
<appender-refref="ConsoleAppender"/>
</root>
</log4net>
</configuration>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }上面例子显示，配置的数据如何嵌入到应用程序 .config 文件，即使该文件直接被 log4net 读取。注意：如果 .NET 配置文件分析器发现，没有通过configSections元素注册，那么，.NET 配置文件分析器将抛出一个异常。因此，上面例子，log4net 小节被注册，但是type指定的处理程序是System.Configuration.IgnoreSectionHandler。这是一个内置类，指示将采用另一个方法读取配置的小节。
配置语法log4net 包含解析 XML DOM 的一个配置读取器，即log4net.Config.XmlConfigurator。本小节说明配置器接受的语法。
下面是一个可用的 XML 配置。根元素必须是 log4net。注意：这不意味着该元素可以嵌入到另一个 XML 文档。关于如何嵌入的更多信息查看 Configuration Files。
<log4net>
<appendername="ConsoleAppender"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
</layout>
</appender>
<root>
<levelvalue="INFO"/>
<appender-refref="ConsoleAppender"/>
</root>
</log4net>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }log4net 元素支持如下属性：
属性
描述
debug
可选。Value must be either true or false. The default value is false. Set this attribute to true to enable internal log4net debugging for this configuration.
update
可选。Value must be either Merge or Overwrite. The default value is Merge. Set this attribute to Overwrite to reset the configuration of the repository being configured before applying this configuration.
threshold
可选。Value must be the name of a level registered on the repository. The default value is ALL. Set this attribute to limit the messages that are logged across the whole repository, regardless of the logger that the message is logged to.
log4net 元素支持如下子元素：
元素
描述
appender
零个或多个。Defines an appender.
logger
零个或多个。Defines the configuration of a logger.
renderer
零个或多个。Defines an object renderer.
root
可选。只能有一个。Defines the configuration of the root logger.
param
零个或多个。Repository specific parameters
追加器（Appenders）appender是log4net元素的子元素。每个appender必须具有唯一的名字。必须指定appender的实现类型type。
下面展示定义一个log4net.Appender.ConsoleAppender的 appender。appender 名为ConsoleAppender。
<appendername="ConsoleAppender"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
</layout>
</appender>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }appender元素的name属性可以为任何你期望的名称。
appender 元素支持如下属性：
属性
描述
name
必需。该值必须是一个 appender 字符串名称（这不废话嘛）。该名称必须在定义配置文件中所有的 appender 中唯一。记录器的 appender-ref 元素会使用该名字引用一个 appender。
type
必需。该值是 appender 的类型名。If the appender is not defined in the log4net assembly this type name must be fully assembly qualified.
appender 元素支持如下子元素：
元素
描述
appender-ref
零个或多个。Allows the appender to reference other appenders. Not supported by all appenders.
filter
零个或多个。Defines the filters used by this appender.
layout
可选。只能有一个。Defines the layout used by this appender.
param
零个或多个。Appender specific parameters.
配置 appenders 的信息参看 Example Appender Configuration 文档。
筛选器（Filters）Filters 是只能定义在 appender，作为它的子元素。
filter 元素支持如下属性：
属性
描述
type
必需。Value must be the type name for this filter. If the filter is not defined in the log4net assembly this type name must be fully assembly qualified.
filter 元素支持如下子元素：
元素
描述
param
零个或多个。Filter specific parameters.
Filter 形成一个事件必须通过的链。沿着这个链的任何 filter 能够接受时间并停止处理，拒绝事件并停止处理，或让事件到下一个 filter。如果事件到达 filter 链的末端，而没有被拒绝，将隐式接受，并被记录。
<filtertype="log4net.Filter.LevelRangeFilter">
<levelMinvalue="INFO"/>
<levelMaxvalue="FATAL"/>
</filter>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }上面配置将记录所有在 INFO 和 FATAL 级别之间的事件。
如果我们只想记录具有指定字符串（如，database），那么需要指定如下 filter：
<filtertype="log4net.Filter.StringMatchFilter">
<stringToMatchvalue="database"/>
</filter>
<filtertype="log4net.Filter.DenyAllFilter"/>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }第一个 filter 将查找事件信息文本中的子字符串 'database'。若发现，则 filter 接受消息，并且 filter 处理将停止，记录信息；否则，事件将被传递给下一个 filter 处理。如果不存在下一个 filter，那么，事件会隐式接受并记录。但是，我们不想记录不匹配的事件，因此，我们需要使用 log4net.Filter.DenyAllFilter，来拒绝所有到达的事件。这个 filter 只在 filter 链的末端有用。
If we want to allow events that have either 'database' or 'ldap' in the message text we can use the following filters:
<filtertype="log4net.Filter.StringMatchFilter">
<stringToMatchvalue="database"/>
</filter>
<filtertype="log4net.Filter.StringMatchFilter">
<stringToMatchvalue="ldap"/>
</filter>
<filtertype="log4net.Filter.DenyAllFilter"/>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }布局（Layouts）Layout 元素只能定义在 appender，作为它的子元素。 Layout 就是具体日志的格式。
layout 元素支持如下属性：
属性
描述
type
必需。Value must be the type name for this layout. If the layout is not defined in the log4net assembly this type name must be fully assembly qualified.
layout 元素支持的子元素：
元素
描述
param
零个或多个。Layout specific parameters.
下面示例演示如何使用log4net.Layout.PatternLayout配置布局。
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
</layout>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }根记录器（Root Logger）Only one root logger element may only be defined and it must be a child of <log4net> element. The root logger is the root of the logger hierarchy. All loggers ultimately inherit from this logger.
An example root logger:
<root>
<levelvalue="INFO"/>
<appender-refref="ConsoleAppender"/>
</root>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }root 元素没有属性。
root 元素支持的子元素：
元素
描述
appender-ref
零个或多个。Allows the logger to reference appenders by name.
level
可选。只能有一个。Defines the logging level for this logger. This logger will only accept event that are at this level or above.
param
零个或多个。Logger specific parameters.
记录器（Loggers）Logger 元素只能定义在 log4net 元素，作为它的子元素。
示例：
<loggername="LoggerName">
<levelvalue="DEBUG"/>
<appender-refref="ConsoleAppender"/>
</logger>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }logger 元素支持的属性如下表所示：
属性
描述
name
必需。Value must be the name of the logger.
additivity
可选。Value may be either true or false. The default value is true. Set this attribute to false to prevent this logger from inheriting the appenders defined on parent loggers.
logger 元素支持的子元素如下表所示：
元素
描述
appender-ref
零个或多个。Allows the logger to reference appenders by name.
level
可选。只能有一个。Defines the logging level for this logger. This logger will only accept event that are at this level or above.
param
零个或多个。Logger specific parameters.
渲染（Renderers）Renderer 元素只能定义在 log4net 元素，作为其子元素。
示例：
<rendererrenderingClass="MyClass.MyRenderer"renderedClass="MyClass.MyFunkyObject"/>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }renderer 元素支持的属性如下表所示：
属性
描述
renderingClass
必需。Value must be the type name for this renderer. If the type is not defined in the log4net assembly this type name must be fully assembly qualified. This is the type of the object that will take responsibility for rendering therenderedClass.
renderedClass
必需。Value must be the type name for the target type for this renderer. If the type is not defined in the log4net assembly this type name must be fully assembly qualified. This is the name of the type that this renderer will render.
renderer 元素没有子元素。
参数（Parameters）Parameter 元素是很多元素的子元素。
示例：
<paramname="ConversionPattern"value="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }param 元素支持的属性如下表所示：
属性
描述
name
必需。Value must be the name of the parameter to set on the parent object.
value
可选。One ofvalueortypeattributes must be specified. The value of this attribute is a string that can be converted to the value of the parameter.
type
可选。One ofvalueortypeattributes must be specified. The value of this attribute is a type name to create and set as the value of the parameter. If the type is not defined in the log4net assembly this type name must be fully assembly qualified.
param 元素支持子元素如下表所示：
元素
描述
param
零个或多个。Parameter specific parameters.
An example param that uses nested param elements:
<paramname="evaluator"type="log4net.spi.LevelEvaluator">
<paramname="Threshold"value="WARN"/>
<param>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }扩展参数（Extension Parameters）配置 parameters 直接映射到一个对象的可写属性。可用的属性取决于被配置对象的实际类型。log4net SDK 文档包含 log4net 程序集中所有组件的 API 引用。
紧凑 Parameter 语法（Compact Parameter Syntax）所有 parameters 可交替使用参数名作为元素名，而不是使用param元素和name属性指定。
示例：
<paramname="evaluator"type="log4net.spi.LevelEvaluator">
<paramname="Threshold"value="WARN"/>
<param>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }可以写为：
<evaluatortype="log4net.spi.LevelEvaluator">
<thresholdvalue="WARN"/>
<evaluator>
.csharpcode, .csharpcode pre
{
font-size: small;
color: black;
font-family: consolas, "Courier New", courier, monospace;
background-color: #ffffff;
/*white-space: pre;*/
}
.csharpcode pre { margin: 0em; }
.csharpcode .rem { color: #008000; }
.csharpcode .kwrd { color: #0000ff; }
.csharpcode .str { color: #006080; }
.csharpcode .op { color: #0000c0; }
.csharpcode .preproc { color: #cc6633; }
.csharpcode .asp { background-color: #ffff00; }
.csharpcode .html { color: #800000; }
.csharpcode .attr { color: #ff0000; }
.csharpcode .alt
{
background-color: #f4f4f4;
width: 100%;
margin: 0em;
}
.csharpcode .lnum { color: #606060; }
下载 Demo、log4netApache log4net™ 手册——概述【翻译】
