『简易日志』NuGet 日志包 SimpleLogger


独立观察员 2020 年 7 月 7 日

一、概述

目前,.NET 框架下,主流的日志组件大致就是 Nlog 和 Log4Net 了,功能比较强大,但总感觉太重了,学习他们的配置规则也是个门槛。当然还有这两者的各种封装变种,以及似乎在 .NET Core 中比较流行的微软官方的 Microsoft.Extensions.Logging,具体没怎么使用过,不好评价。(说到变种,本人曾经也改造过一个 log4net 的版本:https://gitee.com/dlgcy/YTLog ,感兴趣的可以试试)。

其实,对于个人项目或者较小的项目,我们实际只需要将日志内容写入文本文件即可。本人制作的这个 “简易日志 (SimpleLogger)” 包里面包含的代码逻辑,最开始也就是简单地写入文本,后来经过实际使用的演化,做了各种优化,添加了一些实用的特性,感觉用着还不错。正所谓独乐乐不如众乐乐,于是将其打包上传到微软的包管理库 NuGet 中,大家可以使用试试,相互交流。核心代码已托管在码云了:https://gitee.com/dlgcy/dotnetcodes/blob/dlgcy/DotNet.Utilities/ 日志 / LogHelper.cs 。

二、使用方法

1、配置(可选)

配置不是必须的,只有当对于目录、前缀、单条最大长度、保留天数这几项有定制需求时才需要调用 LogHelper.Config () 方法进行配置:

该方法应该在应用程序的启动初期调用,且之后不再调用,建议在程序入口的静态方法中调用。

2、使用

使用 “简易日志 (SimpleLogger)” 记录日志是很容易的,只需调用 LogHelper.Write () 方法即可:

可以看到最少只需传递一个日志内容参数即可。另外还支持是否空行,以及记录调用方信息。

如果之前程序中都是 Console.Write() 这样的,您也无需批量替换,LogHelper 中附带了将控制台信息重定向到日志的辅助类(ConsoleWriter)供您使用:

三、特色

总体来说,” 简易日志 (SimpleLogger)” 拥有如下特色:

(1) 免配置使用;

(2) 便捷配置:指定路径、前缀、单条最大长度、保留天数;

(3) 按日期分文件、自动记录时间和调用信息、连续重复内容仅计数。

着重说一下 “连续重复内容仅计数” 特性,意思就是如果有连续的重复内容,则 “简易日志 (SimpleLogger)” 不会直接输出多条重复内容,仅输出第一条,后续的内容只记录时间和重复到第几次,并且不换行,直到碰到下一条不同的内容为止,效果见下一节。

四、效果展示

不同程序配置到不同目录:

日志文件按照日期分开:

自动记录时间和调用信息:

清理指定天数之前的日志(需配置,默认不清理):

单条最大长度限制:

连续重复内容仅计数(156、157 行):

五、NuGet 包

https://www.nuget.org/packages/SimpleLogger_dlgcy/

支持 .NET Framework 和 .NET Standard(包括 .NET Core),NuGet 包管理器中直接搜索 “简易日志” 即可安装使用:

.NET Framework 项目安装时如果提示源中找不到,可以编辑项目文件,添加上

<PackageReference Include=”SimpleLogger_dlgcy” Version=”1.0.7″ />

祝大家使用愉快!

(0)

相关推荐

  • 7.19洪灾『下乡日志』8月2日: 我们和你战斗在抗洪的一线

    编者按: 今天下乡,教育局分两路陪同河北大地建设科技有限公司的闫文宾.薛玉奇等4位专家,一路到天长镇的北关学校.井陉二中.南峪镇的台头小学.北峪村教学点.贵泉村教学点:一路奔赴辛庄小学.小作.南陉.北 ...

  • 『传统养生』老年足跟痛简易疗法

    足跟痛是中老年人的一种常见病,其表现为站立或行走时,足跟及足底有酸胀疼痛感,严重时呈针刺样痛,难以举步.引起足跟痛的主要原因是体胖.劳累.寒湿或外伤.骨刺等,导致足跟软组织损伤和跟骨退行性病变,或继发 ...

  • 『有货-黄脸婆系列』补水祛斑包

    今天     7.9  第二批上架了.     7.7 准备的第一批补水包已经售罄了,谢谢大家支持,第一批发出去了之后,就会上架第二批.  补水祛斑包      新上一款补水祛斑的药包,该配方来自于伤 ...

  • 『中华秘方』浮肿、腹水: 13.鲤鱼包红豆治肾炎水肿

    [处方名称]鲤鱼包红豆治肾炎水肿 [功能主治]利尿消肿.用治肾炎水肿.消渴水肿. [处方组成]鲜活鲤鱼l条(700克),红小豆70克,陈皮6克,草果5克,葱末.姜块.胡椒.鸡汤及味精各适量. [辨证加 ...

  • 『常用方剂』痈疡剂 : 盆腔包块

    方一 复方毛冬青灌肠液 药物组成 毛冬青15g丹参15g败酱草15g 制剂用法 用20%复方毛冬青灌肠液lOOml保留灌肠.用灌肠器或50ml注射器注入直肠,保留时间1小时以上.每天1次,15次为1疗 ...

  • 『偏方秘方』妇科:产后足跟痛简易疗法

    产后足跟痛多因产后气血亏虚.风寒湿邪侵袭经络关节筋腱,阻滞气血运行所致,主要表现为足跟处酸痛.麻木,并伴有头晕目眩.腰膝酸软等症状. 下面介绍几则行之有效的简易疗法,供选用. 浸泡法:取食醋1000毫 ...

  • 『偏方秘方』内科:简易疗法治失眠

    药枕疗法 取夜交藤200克,合欢花60克,枣仁.柏子仁.五味子各30克碾成粗末,拌匀备用,用纱布缝成枕芯袋,将药置入其内,制成枕芯,再外套枕套即可. 按摩疗法 ①揉百会穴(位于头顶部正中线上,距前发际 ...

  • 『中耳炎集』对付中耳炎、蚕茧包明矾!

    您好胡兵老师,关注您的平台好久了!我给您提供一个治疗中耳炎的秘方,包括打电话时间久的造成耳朵疼的都有效果. 具体方法: 蚕茧7个,每个蚕茧破一个小洞,放少许明矾进去,慢火烧焦,然后研成粉末用香油泡几天 ...

  • 『中医知识』急救常识--水灾后皮炎简易疗法

    在洪涝期间,皮肤如果浸泡在污泥浊水中,就会发痒疼痛,甚至红肿溃烂,这就是患了水灾性皮炎.下面介绍几则行之有效的简易疗法,供患者选用. 1.五倍子250克,白酒1000克,明矾100克(研末)混合2天备 ...