将日志请求插入到应用程序代码中需要进行大量的计划和工作。观察表明，大约4%的代码专门用于日志记录。因此，即使是中等规模的应用程序也会在其代码中嵌入数千条日志记录语句。考虑到它们的数量，必须管理这些日志语句，而不需要手动修改它们。

log4net 环境是完全可编程配置的。但是，使用配置文件配置 log4net 要灵活得多。目前，配置文件是用 XML 编写的。

让我们在使用 log4net 的虚拟应用程序 MyApp 的帮助下，体验一下如何实现这一点。

using Com.Foo;// 导入 log4net 类。
using log4net;
using log4net.Config;public class MyApp 
{// 定义一个静态 logger 变量，其引用名为 "MyApp" 的 Logger 实例private static readonly ILog log = LogManager.GetLogger(typeof(MyApp));static void Main(string[] args) {// 设置一个简单的配置，在控制台进行日志记录。BasicConfigurator.Configure();log.Info("Entering application.");Bar bar = new Bar();bar.DoIt();log.Info("Exiting application.");}
}

MyApp 首先导入 log4net 相关的类。然后，它定义了一个名为 MyApp 的静态 logger 变量，该变量恰好是类的完全限定名。

MyApp 使用了下面的 Bar 类:

// 导入 log4net 类。
using log4net;namespace Com.Foo
{public class Bar {private static readonly ILog log = LogManager.GetLogger(typeof(Bar));public void DoIt(){log.Debug("Did it again!");}}
}

调用 BasicConfigurator.Configure() 方法创建一个相当简单的 log4net 设置。这个方法被硬编码为向 root logger 中添加一个 ConsoleAppender。输出将使用设置为模式 “%-4timestamp [%thread] %-5level %logger %ndc - %message%newline” 的 PatternLayout 来格式化。

注意，默认情况下，root logger 被分配给 Level.DEBUG。

MyApp 的输出为：

0    [main] INFO  MyApp  - Entering application.
36   [main] DEBUG Com.Foo.Bar  - Did it again!
51   [main] INFO  MyApp  - Exiting application.

顺便提一下，在 log4net 中，子 loggers 只链接到它们现有的祖先。特别的，名为 Com.foo.bar 的 logger 直接链接到 root logger，从而绕过了未使用的 Com 或 Com.Foo loggers。这将显著提高性能并减少 log4net 的内存占用。

MyApp 类通过调用 BasicConfigurator.Configure() 方法配置 log4net。其他类只需要导入 log4net 命名空间，检索它们希望使用的 loggers，然后记录日志即可。

前面的示例始终输出相同的日志信息。幸运的是，我们可以很容易地修改 MyApp，以便在运行时控制日志输出。下面一个稍微修改过的版本。

using Com.Foo;// 导入 log4net 类。
using log4net;
using log4net.Config;public class MyApp 
{private static readonly ILog log = LogManager.GetLogger(typeof(MyApp));static void Main(string[] args) {// BasicConfigurator 被 XmlConfigurator 取代。XmlConfigurator.Configure(new System.IO.FileInfo(args[0]));log.Info("Entering application.");Bar bar = new Bar();bar.DoIt();log.Info("Exiting application.");}
}

这个版本的 MyApp 指示 XmlConfigurator 解析配置文件并相应地设置日志记录。配置文件的路径在命令行中指定。

下面是一个示例配置文件，其输出与前面基于 BasicConfigurator 的示例完全相同。

<log4net><!-- A1 被设置为 ConsoleAppender --><appender name="A1" type="log4net.Appender.ConsoleAppender"><!-- A1 使用 PatternLayout --><layout type="log4net.Layout.PatternLayout"><conversionPattern value="%-4timestamp [%thread] %-5level %logger %ndc - %message%newline" /></layout></appender><!-- 将 root logger 级别设置为 DEBUG，并将其唯一的 appender 设置为 A1 --><root><level value="DEBUG" /><appender-ref ref="A1" /></root>
</log4net>

假设我们不再对查看属于 Com.Foo 包的任何组件的输出感兴趣。下面的配置文件展示了实现这一目标的一种可能方法。

<log4net><!-- A1 被设置为 ConsoleAppender --><appender name="A1" type="log4net.Appender.ConsoleAppender"><!-- A1 使用 PatternLayout --><layout type="log4net.Layout.PatternLayout"><!-- 以 ISO 8601 格式打印日期 --><conversionPattern value="%date [%thread] %-5level %logger %ndc - %message%newline" /></layout></appender><!-- 将 root logger 级别设置为 DEBUG，并将其唯一的 appender 设置为 A1 --><root><level value="DEBUG" /><appender-ref ref="A1" /></root><!-- 只打印 Com.Foo 包中 WARN 或更高级别的消息 --><logger name="Com.Foo"><level value="WARN" /></logger>
</log4net>

使用该文件配置的 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.

由于 logger Com.Foo.Bar 没有指定的级别，因此它从 Com.Foo 处继承其级别，Com.Foo 的级别在配置文件中被设置为 WARN。来自 Bar.DoIt 方法的日志语句的级别是 DEBUG，低于 logger 的级别 WARN。因此，DoIt() 方法的日志请求被抑制。

下面是另一个使用多个 appenders 的配置文件。

<log4net><appender name="Console" type="log4net.Appender.ConsoleAppender"><layout type="log4net.Layout.PatternLayout"><!-- 输出调用者的文件名和行号的模式 --><conversionPattern value="%5level [%thread] (%file:%line) - %message%newline" /></layout></appender><appender name="RollingFile" type="log4net.Appender.RollingFileAppender"><file value="example.log" /><appendToFile value="true" /><maximumFileSize value="100KB" /><maxSizeRollBackups value="2" /><layout type="log4net.Layout.PatternLayout"><conversionPattern value="%level %thread %logger - %message%newline" /></layout></appender><root><level value="DEBUG" /><appender-ref ref="Console" /><appender-ref ref="RollingFile" /></root>
</log4net>

使用此配置文件调用增强的 MyApp 将在控制台上输出以下内容。

 INFO [main] (MyApp.cs:16) - Entering application.
DEBUG [main] (Bar.cs:12) - Doing it again!INFO [main] (MyApp.cs:19) - Exiting application.

此外，由于 root logger 已经分配了第二个 appender，因此输出也将定向到 example.log 文件。该文件将在达到 100KB 时进行滚动覆盖。当滚动覆盖发生时，旧版本的 example.log 会自动移动到 example.log.1。

注意，要获得这些不同的日志记录行为，我们不需要重新编译代码。我们同样可以轻松地将日志记录到电子邮件地址，将所有 Com.Foo 的输出重定向到 NT 事件记录器，或者将日志事件转发到远程 log4net 服务器，该服务器会根据本地服务器策略进行日志记录。

有关使用 XmlConfigurator 配置 Appender 的更多示例，请参阅示例 Appender 配置文档。

可以使用程序集级别（assembly-level）的属性来配置 log4net，而不是以编程方式指定。

• XmlConfiguratorAttribute

  log4net.Config.XmlConfiguratorAttribute 允许使用以下的属性配置 XmlConfigurator：

  • ConfigFile

    如果指定了该属性，这是要与 XmlConfigurator 一起使用的配置文件的文件名。该文件路径相对于应用程序基目录（AppDomain.CurrentDomain.BaseDirectory）。

    此属性不能与 ConfigFileExtension 属性一起使用。

  • ConfigFileExtension

    如果指定了该属性，这是配置文件的扩展名。使用程序集文件名作为基本名，然后附加这个扩展名。例如，如果程序集是从 TestApp.exe 文件加载的，并且 ConfigFileExtension 属性设置为 log4net，那么配置文件名就是 TestApp.exe.log4net。这等同于将 ConfigFile 属性设置为 TestApp.exe.log4net。

    配置文件的路径是通过使用应用程序基目录（AppDomain.CurrentDomain.BaseDirectory）、程序集文件名和配置文件扩展名来构建的。

    此属性不能与 ConfigFile 属性一起使用。

  • Watch

    如果指定了该标志并将其设置为 true，则框架将监视配置文件，并在每次修改配置文件时重新加载配置。

  如果没有指定 ConfigFile 或 ConfigFileExtension 属性，则应用程序配置文件（例如 TestApp.exe.config）将被用作 log4net 配置文件。

  使用示例：

  // 使用 .config 文件配置 log4net
  [assembly: log4net.Config.XmlConfigurator(Watch=true)]
  // 这将导致 log4net 在应用程序基目录
  //（即包含 TestApp.exe 的目录）中查找一个
  // 名为 TestApp.exe.config 的配置文件。
  // 该配置文件将被监视以查看更改。
  

  // 使用 .log4net 文件配置 log4net
  [assembly: log4net.Config.XmlConfigurator(ConfigFileExtension="log4net",Watch=true)]
  // 这将导致 log4net 在应用程序基目录
  //（即包含 TestApp.exe 的目录）中查找一个
  // 名为 TestApp.exe.log4net 的配置文件。
  // 该配置文件将被监视以查看更改。
  

  每个程序集只能使用此属性一次。

使用属性可以更清晰地定义应用程序的配置将从何处加载。然而，值得注意的是，属性是纯粹被动的。它们只是信息。因此，如果你使用配置属性，你必须调用 log4net 以便它读取属性。一个简单的对 LogManager.GetLogger 的调用将导致读取和处理调用程序集上的属性。因此，在应用程序启动的尽可能早的阶段进行日志记录调用是至关重要的，当然在加载和调用任何外部程序集之前就更是如此。

如果你使用属性来配置 log4net，则可以使用应用程序配置文件的 appSettings 节的两个设置来覆盖程序集属性中给定的值。

带有 “log4net.Config” 键的设置会覆盖配置文件名（并被认为是相对于您的应用程序的基目录），带有 “log4net.Config.Watch” 键的设置决定是否应监视文件的更改。

即便程序集属性

[assembly: log4net.Config.XmlConfigurator(Watch=false)]

将应用程序配置为使用配置文件 “TestApp.exe.config” 并且不监视它的更改。但您可以通过在应用程序的配置文件中添加

<appSettings><add key="log4net.Config" value="log4net.config"/><add key="log4net.Config.Watch" value="True"/>
</appSettings>

来覆盖此设置，以使用文件 “log4net.config” 并监视它。

通常使用文件指定 log4net 配置。该文件可以通过以下两种方式读取：

• 使用 .NET System.Configuration API
• 直接读取文件内容

log4net 包含一个解析 XML DOM 的配置读取器，即 log4net.Config.XmlConfigurator。本节定义了配置器接受的语法。

下面是一个有效的 XML 配置示例。根元素必须是 <log4net>。注意，这并不意味着这个元素不能嵌入到另一个 XML 文档中。有关如何在配置文件中嵌入 XmlConfigurator XML 的更多信息，请参见上面的配置文件部分。

<log4net><appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" ><layout type="log4net.Layout.PatternLayout"><conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" /></layout></appender><root><level value="INFO" /><appender-ref ref="ConsoleAppender" /></root>
</log4net>

<log4net> 元素支持以下属性：

<log4net> 元素支持以下子元素：

Appender 只能被定义为 <log4net> 元素的子元素。每个 Appender 必须具有唯一的名称。必须指定 Appender 的实现类型。

下面这个例子展示了一个类型为 log4net.Appender.ConsoleAppender 的 Appender 被定义。这个 Appender 将被称为 ConsoleAppender。

<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" ><layout type="log4net.Layout.PatternLayout"><conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" /></layout>
</appender>

<appender> 元素支持以下属性：

<appender> 元素支持以下子元素：

有关配置 appender 的示例，请参见示例 Appender 配置文档。

Filters 元素只能定义为 <appender> 元素的子元素

<filter> 元素支持以下属性：

<filter> 元素支持以下子元素：

filters 形成了一个事件必须通过的链条。沿途的任何 filter 都可以接受事件并停止（过滤）处理，拒绝事件并停止（过滤）处理，或者允许事件传递到下一个过滤器。如果事件在没有被拒绝的情况下到达过滤器链的末端，那么它将被隐式接受并将被记录。

<filter type="log4net.Filter.LevelRangeFilter"><levelMin value="INFO" /><levelMax value="FATAL" />
</filter>

上面这个过滤器将拒绝那些级别低于 INFO 或高于 FATAL 的事件。所有在 INFO 和 FATAL 之间的事件都将被记录。

如果我们只想让包含特定子字符串（例如 ‘database’）的消息通过，那么我们需要指定以下 filters：

<filter type="log4net.Filter.StringMatchFilter"><stringToMatch value="database" />
</filter>
<filter type="log4net.Filter.DenyAllFilter" />

第一个过滤器将在事件的消息文本中查找子字符串 ‘database’。如果找到了文本，过滤器将接受消息并停止过滤处理，消息将被记录。如果没有找到子字符串，事件将被传递给下一个过滤器进行处理。如果没有下一个过滤器，事件将被隐式接受并将被记录。但是因为我们不希望记录不匹配的事件，我们需要使用 log4net.Filter.DenyAllFilter，它将拒绝所有到达它的事件。这个过滤器只在过滤器链的末尾有用。

如果我们想允许消息文本中包含 ‘database’ 或 ‘ldap’ 的事件通过，我们可以使用以下 filters：

<filter type="log4net.Filter.StringMatchFilter"><stringToMatch value="database"/>
</filter>
<filter type="log4net.Filter.StringMatchFilter"><stringToMatch value="ldap"/>
</filter>
<filter type="log4net.Filter.DenyAllFilter" />

Layout 元素只能定义为 <appender> 元素的子元素。

<layout> 元素支持以下属性：

<layout> 元素支持以下子元素：

下例展示了如何配置一个使用 log4net.Layout.PatternLayout 的 layout。

<layout type="log4net.Layout.PatternLayout"><conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
</layout>

只能定义一个 root logger 元素，它必须是 <log4net> 元素的子元素。root logger 是 logger 层次结构的根。所有的 logger 最终都从这个 logger 继承。

一个 root logger 示例：

<root><level value="INFO" /><appender-ref ref="ConsoleAppender" />
</root>

<root> 元素不支持任何属性。

<root> 元素支持以下子元素：

Logger 元素只能定义为 <log4net> 元素的子元素。

一个 logger 示例：

<logger name="LoggerName"><level value="DEBUG" /><appender-ref ref="ConsoleAppender" />
</logger>

<logger> 元素支持以下属性：

<logger> 元素支持以下子元素：

Renderer 元素只能定义为 <log4net> 元素的子元素。

一个 renderer 示例：

<renderer renderingClass="MyClass.MyRenderer" renderedClass="MyClass.MyFunkyObject" />

<renderer> 元素支持以下属性：

<renderer> 元素不支持任何子元素。

Parameter 元素可以是许多元素的子元素。有关详细信息，请参阅上面的特定元素。

一个 param 示例：

<param name="ConversionPattern" value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />

<param> 元素支持以下属性：

<param> 元素支持以下子元素：

一个使用嵌套 param 元素的 param 示例：

<param name="evaluator" type="log4net.spi.LevelEvaluator"><param name="Threshold" value="WARN"/>
<param>

配置参数直接映射到对象上的可写属性。可用的属性取决于正在配置的对象的实际类型。log4net SDK 文档包含了 log4net 程序集中所有组件的 API 参考。

对于第三方组件，请参阅其相关 API 参考以获取可用属性的详细信息。

所有参数也可以通过使用参数名称作为元素名称来指定，而不是使用 param 元素和 name 属性。

例如一个 param：

<param name="evaluator" type="log4net.spi.LevelEvaluator"><param name="Threshold" value="WARN"/>
<param>

也可以写成：

<evaluator type="log4net.spi.LevelEvaluator"><threshold value="WARN"/>
<evaluator>