.Net项目中NLog的配置和使用实例详解

 更新时间:2019年07月15日 09:13:33   作者:追逐时光  
这篇文章主要给大家介绍了关于.Net项目中NLog的配置和使用的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用.Net具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧

引言:

因为之前在项目开发中一直都是使用的Log4Net作为项目的日志记录框架,最近忽然感觉对它已经有点腻了,所以尝试着使用了NLog作为新项目的日志记录框架(当然作为一名有志向的攻城狮永远都不能只局限于眼前的技术,要不断的使用和学习新的技术)。当然serilog也是一个不错的日志记录框架哟,不过今天主要还是要讲述的是NLog在项目中的配置和使用。

NLog框架源码:https://github.com/NLog/NLog

一、导入NLog NuGet PackAge:

二、配置NLog 配置文件:

注意:在这里我是专门新建了一个NLog.config 配置文件用来进行独立配置,当然你也可以在web.config中完成相应的配置!!

NLog详细配置文件信息,请查看官网说明:https://github.com/nlog/nlog/wiki/configuration-file

可参考晓晨大佬的NLog配置:https://www.jb51.net/article/165343.htm

a、我的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">

 <targets>
 <!--此部分中的所有目标将自动异步-->
 <target name="asyncFile" xsi:type="AsyncWrapper">
  <!--项目日志保存文件路径说明fileName="${basedir}/保存目录,以年月日的格式创建/${shortdate}/${记录器名称}-${单级记录}-${shortdate}.txt"-->
  <target name="log_file" xsi:type="File"
    fileName="${basedir}/ProjectLogs/${shortdate}/${logger}-${level}-${shortdate}.txt"
    layout="${longdate} | ${message} ${onexception:${exception:format=message} ${newline} ${stacktrace} ${newline}"
    archiveFileName="${basedir}/archives/${logger}-${level}-${shortdate}-{#####}.txt"
    archiveAboveSize="102400"
    archiveNumbering="Sequence"
    concurrentWrites="true"
    keepFileOpen="false" />
 </target>
 <!--使用可自定义的着色将日志消息写入控制台-->
 <target name="colorConsole" xsi:type="ColoredConsole" layout="[${date:format=HH\:mm\:ss}]:${message} ${exception:format=message}" />
 </targets>

 <!--规则配置,final - 最终规则匹配后不处理任何规则-->
 <rules>
 <logger name="Microsoft.*" minlevel="Info" writeTo="" final="true" />
 <logger name="*" minlevel="Info" writeTo="asyncFile" />
 <logger name="*" minlevel="Warn" writeTo="colorConsole" />
 </rules>
</nlog>

b、NLog配置文件信息简单概述:

1、rules【规则】说明:

  规则是logger具有以下属性的元素:

name - 记录器名称过滤器 - 可能包含通配符(*和?)

minlevel - 记录的最低级别

maxlevel - 记录的最高级别

level - 单级记录

levels - 逗号分隔的记录级别列表

writeTo - 逗号分隔的要写入的目标列表

final - 最终规则匹配后不处理任何规则

enabled- 设置为false禁用规则而不删除它

ruleName- 规则标识符,允许使用Configuration.FindRuleByName和进行规则查找Configuration.RemoveRuleByName。

在NLog 4.6.4中引入

注意:虽然命名了规则logger,但它没有定义记录器。它引用一个或多个记录器。

通过将规则name模式与记录器名称匹配,将规则映射到记录器。规则name属性可以包括通配符(*和?),以通过通配

符匹配来匹配记录器名称。

* - 匹配0个或更多字符

? - 恰好匹配1个字符

2、targets【目标】:

  每个目标由一个target元素表示。每个目标需要两个属性:

name - 目标名称

type - 目标类型 - 例如“文件”,“数据库”,“邮件”。使用名称空间时,此属性已命名xsi:type。

除了这些属性之外,目标通常还接受其他参数,这些参数会影响诊断跟踪的写入方式。每个目标都有一组不同的参数,它们在项目主页上有详细描述,并且它们是上下文相关的。Intellisense也可以在Visual Studio中使用。

例如,File目标接受fileName定义输出文件名的参数,Console目标具有error参数,该参数确定诊断跟踪是否写入标准错误(stderr)而不是进程的标准输出(stdout)。

此示例演示了一个targets定义多个目标的部分:两个文件,一个网络目标和OutputDebugString目标:

< targets >
< target name = “ f1 ” xsi :type = “ File ” fileName = “ file1.txt ” />
< target name = “ f2 ” xsi :type = “ File ” fileName = “ file2.txt ” /> 
< target name = “ n1 ” xsi :type = “ Network ” address = “ tcp:// localhost:4001 ” />
< target name = “ ds ” xsi :type = “ OutputDebugString ” />
</ targets >

NLog提供了许多预定义的目标。实际上创建自己的目标非常容易 - 请参阅如何编写自定义目标。

三、NLog使用:

  在这里,我封装了一个NLog使用帮助类,提供给全站调用,这样就可以避免在不同的类中实例化Nlog对象的步骤。

LoggerHelper.cs:

/// <summary>
 /// nLog使用帮助类
 /// </summary>
 public class LoggerHelper
 {
  /// <summary>
  /// 实例化nLog,即为获取配置文件相关信息
  /// </summary>
  private readonly NLog.Logger _logger = LogManager.GetCurrentClassLogger();

  private static LoggerHelper _obj;

  public static LoggerHelper _
  {
   get => _obj ?? (new LoggerHelper());
   set => _obj = value;
  }

  #region Debug,调试
  public void Debug(string msg)
  {
   _logger.Debug(msg);
  }

  public void Debug(string msg, Exception err)
  {
   _logger.Debug(err, msg);
  }
  #endregion

  #region Info,信息
  public void Info(string msg)
  {
   _logger.Info(msg);
  }

  public void Info(string msg, Exception err)
  {
   _logger.Info(err, msg);
  }
  #endregion

  #region Warn,警告
  public void Warn(string msg)
  {
   _logger.Warn(msg);
  }

  public void Warn(string msg, Exception err)
  {
   _logger.Warn(err, msg);
  }
  #endregion

  #region Trace,追踪
  public void Trace(string msg)
  {
   _logger.Trace(msg);
  }

  public void Trace(string msg, Exception err)
  {
   _logger.Trace(err, msg);
  }
  #endregion

  #region Error,错误
  public void Error(string msg)
  {
   _logger.Error(msg);
  }

  public void Error(string msg, Exception err)
  {
   _logger.Error(err, msg);
  }
  #endregion

  #region Fatal,致命错误
  public void Fatal(string msg)
  {
   _logger.Fatal(msg);
  }

  public void Fatal(string msg, Exception err)
  {
   _logger.Fatal(err, msg);
  }
  #endregion
 }

四、运行记录结果:

  因为我在NLog.config配置文件中配置的日志存储路径为:ProjectLogs/当前时间(yyyy-MM-dd)/
如下图所示:

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对脚本之家的支持。

相关文章

  • WPF的数据绑定详细介绍

    WPF的数据绑定详细介绍

    数据绑定:是应用程序 UI 与业务逻辑之间建立连接的过程。 如果绑定正确设置并且数据提供正确通知,则当数据的值发生更改时,绑定到数据的视觉元素会自动反映更改。 数据绑定可能还意味着如果视觉元素中数据的外部表现形式发生更改,则基础数据可以自动更新以反映更改。
    2013-03-03
  • 蛇年多屏图片切换(可添加图片链接以及编辑标题)

    蛇年多屏图片切换(可添加图片链接以及编辑标题)

    朋友要求,做一个多屏图片切换效果可添加图片,链接以及标题,前台不必在每次更新时,去修改前台代码
    2013-01-01
  • asp.net jquery无刷新分页插件(jquery.pagination.js)

    asp.net jquery无刷新分页插件(jquery.pagination.js)

    采用Jquery无刷新分页插件jquery.pagination.js 实现无刷新分页效果:本示例Handler中采用StringBuilder的append方法追加HTML,小数据量可以,但是大数据或是布局常变,建议返回JSON格式的数据,性能和灵活性更好,望使用者好好把握
    2013-01-01
  • 在Repeater控件中通过Eval的方式绑定Style样式代码

    在Repeater控件中通过Eval的方式绑定Style样式代码

    这篇文章主要介绍了如何在Repeater控件中通过Eval的方式绑定Style样式,需要的朋友可以参考下
    2014-04-04
  • DataGrid 动态添加模板列 实现代码

    DataGrid 动态添加模板列 实现代码

    模版控件能让用户几乎不用花费任何时间就创建出复杂的用户界面. Asp.net有很多控件都使用了模版技术(DataGrid就是一个例子). 而这些控件都工作得很好, 通常, 模版可以被保存为ascx文件以增加复用性. 很有可能, 事前你是不知道你的控件是怎么布局的, 而且你需要动态的添加一些模版以应付不同的事件.
    2009-04-04
  • asp.net URL 显示乱码 解决方法

    asp.net URL 显示乱码 解决方法

    刚刚接触网页开发,不过遇到URR参数传递错误的问题,两个页面进行信息交互时可以用url进行传递,但是如果传递信息的编码格式不是UTF-8(或者不是设置的默认格式)URL传递时会出现乱码。
    2009-06-06
  • 深入浅析WinForm 进程、线程及区别介绍

    深入浅析WinForm 进程、线程及区别介绍

    进程是一个具有独立功能的程序关于某个数据集合的一次运行活动。线程,有时被称为轻量级进程(Lightweight Process,LWP),是程序执行流的最小单元。这篇文章主要介绍了WinForm 进程、线程的相关资料,需要的朋友可以参考下
    2016-09-09
  • ASP.NET中等安全模式的一些经验分享

    ASP.NET中等安全模式的一些经验分享

    如果你正在开发一个通用型的Web产品,比如BBS、CMS、BLOG这类的,那么,建议你阅读以下本篇文章。
    2010-01-01
  • asp.net实现三层架构的例子

    asp.net实现三层架构的例子

    这篇文章主要介绍了asp.net实现三层架构的例子,十分的简单实用,有需要的小伙伴可以参考下。
    2015-07-07
  • vscode extension插件开发详解

    vscode extension插件开发详解

    这篇文章主要介绍了vscode extension插件开发,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-05-05

最新评论