一、NLog是什么？
NLog是一个基于.NET的免费的开源的日志记录类库。（官网：http://nlog-project.org/）
NLog特点如下：
- 配置简单方便。可以将配置信息写的应用程序的配置文件中，或者写到单独的 NLog.config 配置文件中。
- 修改配置信息后立即生效，不用重启应用程序。通过设置 <nlog autoReload="true" /> 来实现。
- 内置了丰富的模板变量layout renders。例如： ${date} , ${level} , ${message} 等。
- 可以将日志记录到多个目标targets。例如：控制台、输出窗口、文件、数据库、邮件等。
- 支持扩展，可自定义目标。
使用NLog的理由如下：
- 能够通过简单的配置和修改控制显示不同等级的跟踪信息。
- 将控制跟踪信息的显示与否的逻辑与代码分开，修改跟踪信息的显示不需要重新编译程序。
二、第一个NLog程序
1、创建控制台程序
此处只是为测试NLog，所以创建一个简单控制台应用程序，名称为NLogConsoleDemo，如图：
注意：此处选择的程序位置应选择应用程序可以创建文件的路径。
2、引用NLog程序集
可以通过两种方式应用NLog，分别如下：
1）通过程序包管理控制台安装，命令如下： PM> Install-Package NLog.Config 。（推荐）
2）通过官网下载源码。
通过方式一安装结果如图：
注意：一定要修改NLog.config文件的属性中复制到输出目录的值为始终复制或如果较新则复制。
3）添加代码
建议通过 LogManager 创建一个私有静态（ private sttatic ）的 Logger 类对象进行日志记录，代码如下：
using NLog;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks; namespace NLogConsoleDemo
{
class Program
{
private static Logger logger = LogManager.GetCurrentClassLogger(); static void Main(string[] args)
{
LogTest();
LogTest2(); Console.ReadLine();
} public static void LogTest()
{
logger.Trace("Sample trace message");
logger.Debug("Sample debug message");
logger.Info("Sample informational message");
logger.Warn("Sample warning message");
logger.Error("Sample error message");
logger.Fatal("Sample fatal error message"); // alternatively you can call the Log() method
// and pass log level as the parameter.
logger.Log(LogLevel.Info, "Sample informational message");
} public static void LogTest2()
{
int k = ;
int l = ; logger.Trace("Sample trace message, k={0}, l={1}", k, l);
logger.Debug("Sample debug message, k={0}, l={1}", k, l);
logger.Info("Sample informational message, k={0}, l={1}", k, l);
logger.Warn("Sample warning message, k={0}, l={1}", k, l);
logger.Error("Sample error message, k={0}, l={1}", k, l);
logger.Fatal("Sample fatal error message, k={0}, l={1}", k, l);
logger.Log(LogLevel.Info, "Sample informational message, k={0}, l={1}", k, l);
}
}
}
4）配置NLog
可以在应用程序配置文件或NLog.config文件中配置NLog，此处我们直接修改NLog.config文件，修改后如下：
<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.nlog-project.org/schemas/NLog.xsd NLog.xsd"
autoReload="true"
throwExceptions="false"
internalLogLevel="Off" internalLogFile="c:\temp\nlog-internal.log" > <targets>
<!--屏幕打印消息-->
<target name="console" xsi:type="ColoredConsole" layout="${date:format=yyyy-MM-dd HH\:MM\:ss.ffff} | ${message}"/>
<!--VS输出窗口-->
<target name="debugger" xsi:type="Debugger" layout="${shortdate} | ${level:padding=-5} | ${message}" />
<!--保存至文件-->
<target name="error_file" xsi:type="File" maxArchiveFiles="" fileName="${basedir}/logs/error.log" />
</targets>
<rules>
<logger name="*" minlevel="Trace" writeTo="console" />
<logger name="*" minlevel="Debug" writeTo="debugger" />
<logger name="*" minlevel="Error" writeTo="error_file" />
</rules>
</nlog>
现在可以编译运行程序，测试运行是否正常。正常情况下，我们可以在控制台、输出窗口和日志文件中看到记录的日志信息。
注意：在开发阶段，建议设置 <nlog throwExceptions="true" /> ，方便快速定位问题。