一个功能丰富的 .NET 工具库 XiHan.Framework.Utils-牛翰网

概述

XiHan.Framework.Utils 是一个功能丰富的 .NET 工具库，涵盖了开发中常用的字符串处理、集合扩展、加密解密、分布式ID、文件IO、反射、缓存、线程、系统工具、国际化、网络、硬件信息、异常、数据过滤、Linq扩展等模块。本库以高内聚、低耦合为设计理念，适用于各类 .NET 应用开发。

目录结构与模块说明

1. Verifications（验证工具）

RegexHelper：正则表达式相关工具，支持常用正则校验。
DataChecker：数据有效性检查工具，支持多种数据类型的校验。

2. Security（安全工具）

Cryptography/ ：加密解密工具（如AesHelper等）。
OtpHelper：一次性密码生成。
MaskHelper：敏感信息掩码。
PasswordStrengthChecker：密码强度检测。
TextWatermarkHelper：文本水印处理。
ValidateCoder：验证码生成与校验。

3. Text（文本处理）

StringHelper：字符串分割、组装、格式化、长度计算、HTML转文本等。
StringExtensions：字符串扩展方法。
EncodingExtensions：编码扩展。
Json/Xml/Yaml/Template：JSON、XML、YAML、模板处理工具。

4. DistributedId（分布式ID生成）

IDistributedIdGenerator：分布式ID生成接口。
SnowflakeIdGenerator：雪花算法ID生成器。
UuidGenerator：UUID生成。
IdGeneratorFactory/Options：ID生成器工厂与配置。

5. Collections（集合扩展）

List/Dictionary/Collection/Enumerable/TreeExtensions：集合、字典、树结构等扩展方法，支持树形结构转换、集合去重、查找等。

6. Timing（时间处理）

DateTimeFormatExtensions：日期时间格式化扩展。
DateTimeRange：时间区间处理。

7. Maths（数学工具）

MathHelper：常用数学计算。
MoneyFormatExtensions：金额格式化扩展。

8. Configuration（配置工具）

DeepMergeHelper：对象深度合并工具，支持复杂配置合并。

9. Reflections（反射工具）

Assembly/Field/Method/Member/PropertyInfoExtensions：反射相关扩展，支持类型、属性、方法等元数据操作。
LockExtensions：锁相关扩展。

10. Caching（缓存工具）

MemoryCache：内存缓存实现。
CacheManager：缓存管理器。

11. Threading（线程工具）

Async/AsyncLock/AsyncHelper/Debouncer/DisposeAction：异步锁、去抖动、异步辅助、资源释放等。

12. System（系统工具）

Parse/Enum/Type/Object/GenericExtensions：类型转换、枚举、对象操作、泛型扩展等。
RandomHelper：随机数工具。
CheckHelper：通用检查工具。
GuidHelper：GUID工具。

13. CommandLine（命令行工具）

ScriptExecutor：脚本执行器。
ShellHelper：Shell命令辅助。

14. Attributes（自定义特性）

ThemeAttribute：主题特性。

15. IO（文件与流操作）

File/Directory/Stream/CompressHelper：文件、目录、流、压缩等操作。
FileFormatExtensions：文件格式扩展。

16. Logging（日志工具）

ConsoleLogger：控制台日志输出。

17. Net（网络工具）

PingHelper：Ping工具。
IpFormatExtensions：IP格式化扩展。
Sftp/Ssh/Http/Sse/WebSocket：网络协议相关工具。

18. I18n（国际化工具）

Format/Language/TimeZone/CurrencyHelper：格式化、多语言、时区、货币等国际化支持。

19. Runtime（运行时工具）

OSPlatformHelper：操作系统平台辅助。

20. HardwareInfos（硬件信息）

Cpu/Disk/Network/Ram/Board/RunningTimeHelper：CPU、磁盘、网络、内存、主板、运行时间等硬件信息获取。

21. Exceptions（异常处理）

CustomException：自定义异常类型。

22. DataFilter（数据过滤与分页）

Paging：分页扩展、条件解析、排序、DTO、枚举等，支持复杂数据分页与过滤。

23. Linq（Linq扩展）

Expressions：表达式树扩展、Queryable扩展。

典型用法示例

字符串处理

// 分割字符串为列表
var list = StringHelper.GetStrList("a,b,c", ',');
// 组装列表为字符串
var str = StringHelper.GetListStr(list, ',');

集合扩展

// 树形结构转换
var tree = list.ToTree(x => x.Id, x => x.ParentId, x => x.Children);

加密解密

// AES加密
string encrypted = AesHelper.Encrypt("明文", "密码");
// AES解密
string decrypted = AesHelper.Decrypt(encrypted, "密码");

分布式ID

var generator = IdGeneratorFactory.CreateSnowflakeIdGenerator(new IdGeneratorOptions { WorkerId = 1 });
long id = generator.NextId();

文件操作

FileHelper.WriteAllText("test.txt", "内容");
string content = FileHelper.ReadAllText("test.txt");

缓存

MemoryCache.Set("key", value, TimeSpan.FromMinutes(5));
var value = MemoryCache.Get("key");

异步锁

using (await asyncLock.LockAsync())
{
    // 线程安全操作
}

国际化

string currency = CurrencyHelper.Format(100, "CNY");

分页与数据过滤

var pageInfo = new PageInfoDto { PageIndex = 1, PageSize = 10 };
var pagedData = dataList.ToPagedList(pageInfo);

安装

方式一：使用 Visual Studio 包管理器控制台

Install-Package XiHan.Framework.Utils

方式二：使用 .NET CLI

dotnet add package XiHan.Framework.Utils

方式三：通过 Visual Studio 图形界面

右键点击你的项目，选择“管理NuGet程序包”。
搜索 XiHan.Framework.Utils。
点击“安装”。

源码

https://github.com/XiHanFun/XiHan.Framework/tree/main/framework/src/XiHan.Framework.Utils

许可证

MIT License

来源链接：https://www.cnblogs.com/zhaifanhuablog/p/18859734

本站所有资源来自于网络，仅供学习与参考，请勿用于商业用途，否则产生的一切后果将由您(转载者)自己承担！
如有侵犯您的版权，请及时联系3500663466#qq.com(#换@)，我们将第一时间删除本站数据。

THE END

ASP.NET 后端开发编程开发