log4net翻译.docxVIP

log4net教程 介绍 在那些最棒的日志记录工具中为.net定制的是log4net。这个软件是如何记录日志的黄金定律。它很简单，功能强大，易于扩展。还有什么能够更好？在我看来，我看的是缺乏一个直接的教程来说明如何去使用log4net。它的文档深入的讲解了如何去使用它，但是有点模糊。基本上，如果你已经知道log4net能够做什么，而且你刚好知道它的语法，那么那些文档就是为你准备的。当前的教程一般介绍了一片或者一种类型的系统。我希望至少我能够增加一些教程，也许我能提供你一个完整的教程，包含我所遇到的一些问题。下面的demo和信息是以log4net团队提供的文档为基础的。 基础 Log4net包含三个部分，它们是配置，安装还有调用。配置部分一般在app.config或者web.config中完成。在下文我们将深入学习。如果你渴望通过使用分离的配置文件来追求更加灵活的做法，那么请看“远离app.config”章节。不管你采用何种方式来存储配置信息，为了实现软件安装和连接日志的实例，基本上都是几行代码搞定。最后，最简单的部分就是调用他。如果你配置安装正确，它会非常简单，易于理解。 日志级别 它有七个日志级别，其中有五个可以在你的代码中调用。他们如下所示： OFF：什么都不记录（不能被调用） FATAL：致命的记录 ERROR：错误记录 WARN：警告 INFO：提示 DEBUG：调试记录 ALL：所有都被记录（不能被调用） 无论是在你的代码中还是在配置文件里，这里等级将多次被使用。除了第一个和最后一个，这些等级代表着什么没有设置相应的规则。 配置 安装log4net标准的方式就是使用桌面应用程序的app.config文件或者使用web应用程序的web.config文件。为了顺利的使用log4net，必须将几条信息设置在配置文件当中。这些部分将告诉log4net如何配置它自己。在不重新编译应用程序的情况下，这些设置信息可以被改变，这是配置文件的重点。 Root 你需要有一个root块来放置顶级logger引用。其他loggers从顶级logger继承信息。Root块存储的唯一其他信息是记录日志的最低级别。因为一切都继承自root块，所以没有一个appenders记录的级别低于这个指定的级别。在你的应用程序中，这是控制日志级别非常简单的方式。下面是一个使用默认INFO级别的例子（这意味着DEBUG级别的信息将被忽略），作为两个appenders的参考，INFO级别应该被启用。 root levelvalue=INFO/ appender-refref=FileAppender/ appender-refref=ConsoleAppender/ /root 其他Loggers 有时候你想知道关于你应用程序一个特定部分更多的信息。Log4net允许你指定额外的logger参考来对其进行预期，而不仅仅通过root logger。例如，下面是我在配置文件中设置的一个额外的logger，它将记录发生在OtherClass类对象内部的控制台信息。 loggername=Log4NetTest.OtherClass levelvalue=DEBUG/ appender-refref=ConsoleAppender/ /logger 需要注意的是，logger的名称是包含命名空间的类的全名。如果你想监控整个命名空间，你只需要简单的列出你想要监控的命名空间即可。我反对在多个logger中重用一个appenders。它确实是可以做到的，但是你会得到一些不可预测的结果。 ConfigSections 在配置文件中，除了log4net配置信息外，将有更多的信息被存储，你需要指定一个section去识别log4net的配置信息放置在哪里。下面这个简单的section说明配置信息将会存储在xml标签“log4net”下。 configSections section name=log4net type=log4net.Config.Log4NetConfigurationSectionHandler, log4net/ /configSections Appender (General) Appender是记录日志信息工具的名字。它指明了的信息将会被记录什么地方，如何被记录，在什么样的情况下信息才会被记录。尽管根据数据的走向每个appender都由不同的参数，但是它们都由一些通用的元素。第一个是这个appender的名称和类型。每个appender都由被分配一个名称和类型。下面是一个appender的例子： appendername=ConsoleAppendertype=log4net.Appender.ConsoleAppender Layout 在每个appe