[C#] 将NLog输出到RichTextBox，并在运行时动态修改日志级别过滤

小贝

作者： zyl910

一、缘由

NLog是一个很好用的日志类库。利用它，可以很方便的将日志输出到 调试器、文件 等目标，还支持输出到窗体界面中的RichTextBox等目标。
而且它还支持在运行时修改配置，例如可用于实现这样的需求——在界面上做个下拉框，可动态调整RichTextBox的日志级别过滤。

二、输出到RichTextBox 2.1 办法

首先，项目中需要加入NLog的程序包。既用 NuGet 下载这些包——

• NLog
• NLog.Config
• NLog.Windows.Forms

随后便可修改 NLog.config 文件，增加RichTextBox目标了。
这时有2点需注意——

1. RichTextBox的target配置中，formName是“RichTextBox所在窗体的类名”，controlName是“该窗体中的RichTextBox控件名”。区分大小写，需要完全一致。
2. 在NLog加载配置前，需要确保该RichTextBox已存在。

若以上2条中有任意一条不符时，NLog会自动弹出一个含RichTextBox的小窗口来显示日志，而不是你所指定的RichTextBox。
这2中，第1条是很容易实现的，就是第2条稍微麻烦一点。它的处理诀窍是，不要做静态初始化，而是要等到窗体的Load事件时才初始化Logger对象，且保证该窗体是首个使用NLog的类。这是因为NLog是在首次被使用时，才加载配置文件的。

即不能这样写——

1. private static Logger logger = LogManager.GetCurrentClassLogger();

复制代码

而是要这样写——

1. private static Logger logger = null;
3. private void MainForm_Load(object sender, EventArgs e) {
4. if (null == logger) {
5. logger = LogManager.GetCurrentClassLogger();
6. }
7. }

复制代码

2.2 范例

假设窗体名（formName）为MainForm，RichTextBox控件名为rtbLog。那么 NLog.config 配置文件可写成这样——

1. <?xml version="1.0" encoding="utf-8" ?>
2. <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xsi:schemaLocation="http://www.nlog-project.org/schemas/NLog.xsd NLog.xsd"
5. autoReload="true"
6. throwExceptions="false"
7. internalLogLevel="Off" internalLogFile="c:\temp\nlog-internal.log">
9. <targets async="true">
10. <target xsi:type="Debugger" name="debugger" layout="${longdate} ${level:uppercase=true} [${threadname}] ${message} ${onexception:${exception:format=tostring} ${newline}}" />
11. <target xsi:type="File" name="f"
12. fileName="${basedir}/logs/${shortdate}.log"
13. layout="${longdate} ${level:uppercase=true} [${threadname}] ${message} ${onexception:${exception:format=tostring} ${newline}}"
14. encoding="utf-8" />
15. <target xsi:type="RichTextBox" name="richTextBox"
16. layout="${longdate} ${level:uppercase=true} [${threadname}] ${message} ${onexception:${exception:format=Message}}"
17. autoScroll="true"
18. maxLines="1000"
19. formName="MainForm"
20. controlName="rtbLog"
21. useDefaultRowColoringRules="false" />
22. </targets>
24. <rules>
25. <logger name="*" minlevel="Debug" writeTo="debugger" />
26. <logger name="*" minlevel="Info" writeTo="f" />
27. <logger name="*" minlevel="Info" writeTo="richTextBox" />
28. </rules>
29. </nlog>

复制代码

上面的配置文件还演示了这些功能——

• 将日志输出到调试器（Debugger）。
• 将日志输出到文件（File）。且是log子目录下每天一个文件（fileName="${basedir}/logs/${shortdate}.log"），编码指明为utf-8（encoding="utf-8"）避免gbk外字符乱码。
• 采用不同的日志字符串格式（layout）。RichTextBox只显示异常消息（Message），而不显示包含错误栈的异常详情（tostring）。
• 目标都是异步模式（）。
• 支持自动重新加载配置（autoReload="true"）。

三、动态修改日志级别 3.1 需求

首先，NLog支持自动重新加载配置的机制，可参考上面配置的 autoReload="true"。即修改NLog.config的配置，会对运行中的程序也是生效的，这样便无需重启程序了。

但对于RichTextBox输出的日志来说，上述机制还不够方便。最好是界面上提供一些直接调整日志配置的功能。例如——RichTextBox最初的最小日志级别为Info级，当想看详细日志时，可点界面的下拉框，便可将最小日志级别改为Debug级。

3.2 办法

NLog提供了动态修改配置的接口。

调用 LogManager.Configuration ，可得到 LoggingConfiguration 对象。它就是当前的配置数据。
然后可通过 LoggingConfiguration.LoggingRules，获取日志规则集合（即 ）。这样便能就行修改对应的配置了。
最后别忘了调 LogManager.ReconfigExistingLoggers，使修改的配置生效。

3.3 范例

可这样实现下拉选择RichTextBox日志级别过滤的功能——在窗体放一个名为 cboLogLevelMin 的下拉框，配好属性，然后处理它的 SelectedIndexChanged 事件。

1. private void cboLogLevelMin_SelectedIndexChanged(object sender, EventArgs e) {
2. if (null == cboLogLevelMin.SelectedItem) return;
3. String str = cboLogLevelMin.SelectedItem.ToString(); // 获取日志级别.
4. LogLevel lv = LogLevel.Info; // 若选择的值无效, 则当作 Info级.
5. try {
6. lv = LogLevel.FromString(str);
7. } catch (Exception ex) {
8. if (null == logger) return;
9. logger.Debug(ex, "LogLevel.FromString fail!");
10. }
11. LoggingConfiguration lc = LogManager.Configuration; // 取得 NLog 配置.
12. LoggingRule lr = lc.LoggingRules.FirstOrDefault(
13. r => r.Targets.Any(
14. t => "richTextBox" == t.Name
15. )
16. ); // 查找 RichTextBox 所用的 LoggingRule .
17. if (null != lr) {
18. lc.LoggingRules.Remove(lr); // 删除旧的 LoggingRule .
19. }
20. lc.AddRule(lv, LogLevel.Fatal, "richTextBox"); // 新增 LoggingRule .
21. LogManager.ReconfigExistingLoggers(); // 使配置生效.
22. }

复制代码

参考文献

• NLog wiki《RichTextBoxTarget》 . https://github.com/NLog/NLog.Windows.Forms/wiki/RichTextBoxTarget
• tvsofa2008《将NLog target设置为RichTextBox的注意事项，NLog版本4.2.1》 . http://blog.csdn.net/tvsofa2008/article/details/50081397
• GavinJun《NLog类库使用探索——详解配置》 . https://www.cnblogs.com/fuchongjundream/p/3936431.html
• viviachen《如何在运行时修改NLog配置》 . http://blog.csdn.net/viviachen/article/details/19171681

（完）