C#第三方日志库Nlog

最新推荐文章于 2025-07-02 08:08:30 发布

原创最新推荐文章于 2025-07-02 08:08:30 发布 · 1w 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#c# #silverlight #layout #exception #file #date

C# 专栏收录该内容

58 篇文章

订阅专栏

本文介绍了C#中如何使用第三方日志库Nlog，包括配置Nlog.config文件，设置Logger标签对控制输出范围和级别，以及Target标签对定义输出格式和目的地。在Silverlight项目中使用Nlog的注意事项也进行了说明。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

C#第三方库Nlog

Kagula

2012-03-31

内容简介

本文记录C#的NLog库（日志库）的常用方式。所有代码在WinXPSP3+VS2010SP1环境中测试通过。

使用的第三方库是Sentinel 0.9.2.0，NLog-v2.0.0.2000。

如果是在Silverlight项目中使用NLog请参考资料[4]。

正文

第一次使用

在参考资料[2]中找到download下载Nlog安装包，在系统中安装。

新建C#的Win32Console项目，鼠标右键单击项目名称，添加新项目[Visual C# Items]->[CSharp]->[Empty Nlog configuration file]，缺省名称为“Nlog.config”的文件。你可以在项目中使用快捷键[Ctrl]+[Shift]+[A]添加“Nlog.config”文件，同时Nlog.DLL文件也会被加入到项目中去。

下面在Program.cs中填入缺省代码

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using NLog;

namespace testNLog
{
    class Program
    {
        private static Logger logger = LogManager.GetCurrentClassLogger();

        public static void MyMethod1()
        {
            int k = 42;
            int l = 100;

            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 fatal error message, k={0}, l={1}", k, l);
        }

        static void Main(string[] args)
        {
            logger.Info("---------------------------------------");
            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 fatal error message");

            MyMethod1();
        }
    }
}

下面在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">

  <!-- make sure to set 'Copy To Output Directory' option for this file -->
  <!-- go to http://nlog-project.org/wiki/Configuration_file for more information -->

  <targets>
    <target name="asyncFile" xsi:type="AsyncWrapper">
      <target name="logfile" xsi:type="File" fileName="file.txt" />
    </target>
    <target name="console" xsi:type="ColoredConsole" 
             layout="[${date:format=yyyy-MM-dd HH\:mm\:ss}][${level}] ${message} ${exception}"/>
  </targets>

  <rules>
    <logger name="*" minlevel="Info" writeTo="logfile" />
    <logger name="*" minlevel="Trace" writeTo="console" />
  </rules>
</nlog>

上面这个例子演示了，日志信息如何输出到控制台和文件中。文件中的Target标签对有个嵌套，最外层是个“AsyncWrapper”类型的Target标签对，使信息以异步方式输出到日志文件。

添加的NLog.config文件必须放在项目对应的DEBUG目录或RELEASE目录中，即必须放在和可执行文件相同的路径中。

Logger标签对，控制输出范围与水平

name属性：

指定哪些代码段要输出信息，例如：“<logger name="SomeNamespace.Component.*" …”，只输出SomeNamespace.Component域里面打印的信息。

minLevel属性:

指定输出等级，Logging 水平分为以下等级“Trace<<Debug<<Info<<Warn<<Error<<Fatal ”，如果我们选择Info值，则Trace和Debug等级的信息不会被输出。

writeTo属性：

指定使用那个“Target标签对”来输出信息

Final属性：

这个属性若设置为true，则被当前Logger标签对输出的消息类型，不再被下一个Logger标签对处理。例如:

   <rules>

       <logger name="SomeNamespace.Component.*"minlevel="Trace" writeTo="logfile" final="true"/>

       <logger name="*" minlevel="Info"writeTo="logfile2" />

</rules>