();//获取值
```
### 51. ASP.NET Core自动扫描注册服务
包：Masuit.Tools.AspNetCore
```csharp
// 自动扫描注册服务
services.AutoRegisterServices();
// 需要自动注册的服务打上ServiceInject标记即可。
[ServiceInject(ServiceLifetime.Scoped)]
public class MyClass:MyInterface{...}
[ServiceInject(ServiceLifetime.Scoped)]
public class MyService{...}
```
### 52. 文本对比(支持html和纯文本)
集成案例：https://masuit.org/1889/history
```csharp
var text1 = "你好 UEditorPlus
UEditorPlus 是基于 UEditor 二次开发的富文本编辑器，让 UEditor 焕然一新
公式支持
![](\"https://r.latexeasy.com/image.svg?%5Cint%20%5Cfrac%7B1%7D%7Bx%7D%20dx%20%3D%20%5Cln%20%5Cleft%7C%20x%20%5Cright%7C%20%2B%20C\")
";
var text2 = "UEditorPlus 是基于 UEditor 二次开发的富文本编辑器，让 UEditor 焕然
一新
<div>\r\n <span>这里是HTML标签</span>\r\n</div>
公式支持23333333
";
var (html1, html2) = text1.HtmlDiff(text2); // 对比两段文本并分别生成差异
var diffs = TextDiffer.Compute(text1, text2); // 对比两段文本并分别生成差异详细记录
var patches = DiffPatch.FromDiffs(diffs); // 根据差异信息生成补丁
patches.ToText(); // 根据补丁记录重建文本
(string newText, bool[] results) = patches.Apply(text1); // 将变更补丁应用到原始文本1，并返回是否应用成功
var text1 = diffs.Text1(); // 根据差异信息还原文本1
var text2 = diffs.Text2(); // 根据差异信息还原文本2
var delta = diffs.ToDelta(); // 根据差异信息生成类似于git差异的差分记录
var diffs = text1.FromDelta(delta); // 根据差分信息生成差异记录
```
### 53. 房贷试算模型
集成案例：https://masuit.org/tools/loan
**支持多次提前还款和多次调整利率，同时支持提前还款时变更贷款方式和缩短年限，如有利率调整或提前还款计划，因银行计算受实时利率或提前还款违约金影响，本试算模型的计算结果和银行结果大约有1‰的误差，结果仅供参考，请以银行结果为准。**
模拟案例：
贷款100万，
初始利率6.27%，
等额本息方式，
贷30年，
首次还款时间2021-2-1。
利率调整：
2022-1-1利率调整为5.92%，LPR调整
2023-1-1利率调整为5.85%，LPR调整
2023-9-25利率调整为4.3%，政策因素银行自动调整
2025-1-1利率调整为4.2%，LPR调整
2026-1-1利率调整为4.1%，LPR调整
提前还款计划：
2022-10-23提前还款10万，贷款方式不变，
2023-10-11提前还款10万并缩短年限(`实际目前银行政策不允许`)，
2025-10-12提前还款10万并修改为等额本金方式，
2026-10-14提前还款10万并以等额本金方式+缩短年限(`实际目前银行政策不允许`)。
计算代码如下：
```csharp
var (totalInterest, actualInterest, savedInterest, totalRepayment, actualPayment, paymentPlans) = new LoanModel(1000000, 0.0627m, 360, DateTime.Parse("2021-2-1"))
{
RateAdjustments = new Dictionary()
{
[DateTime.Parse("2022-1-1")] = 0.0592m, // 调整前月供6170.19，调整后月供5948.53
[DateTime.Parse("2023-1-1")] = 0.058m, // 调整前月供5948.53，调整后月供5273.92
[DateTime.Parse("2023-9-25")] = 0.043m, // 调整前月供5273.92，调整后月供4496.91，调整次月还款5118.55
[DateTime.Parse("2025-1-1")] = 0.042m, // 调整前月供4496.91，调整后首月4457.15
[DateTime.Parse("2026-1-1")] = 0.041m, // 调整前月供4762.47，调整后月供4702，调整次月还款8.87元(还款方式改为了等额本金)
},
Prepayments = new List()
{
new(DateTime.Parse("2022-10-23"), 100000m, false, LoanType.EquivalentInterest), // 提前还款前月供5948.53，提前还款后月供5339.85
new(DateTime.Parse("2023-10-11"), 100000m, true, LoanType.EquivalentInterest), // 提前还款前月供5273.92，提前还款后月供4493.84，期数减少64期
new(DateTime.Parse("2025-10-12"), 100000m, false, LoanType.EquivalentPrincipal), // 提前还款前月供4771.56，提前还款后月供首月4762.47，每月递减60.4元
new(DateTime.Parse("2026-10-14"), 100000m, true, LoanType.EquivalentPrincipal), // 提前还款前月供4260.28，提前还款后月供首月4251.44，每月递减8.84元，期数减少38期
}
}.Payment();
```
计算结果：
总利息totalInterest：1221266.8
实际支付利息actualInterest：403845.58
提前还款节省利息savedInterest：817421.22
总提前还款totalRepayment：400000.00
实际还款总额actualPayment：1403845.58
总还款期数paymentPlans：258期，**List类型，每条记录可以展示当期的利率，利息，本金，剩余本金等信息**
# Asp.Net MVC和Asp.Net Core的支持断点续传和多线程下载的ResumeFileResult
在ASP.NET Core中通过MVC/WebAPI应用程序传输文件数据时使用断点续传以及多线程下载支持。
它提供了 `ETag`标头以及 `Last-Modified`标头。 它还支持以下前置条件标头：`If-Match`，`If-None-Match`，`If-Modified-Since`，`If-Unmodified-Since`，`If-Range`。
## 支持 ASP.NET Core 2.0+
从.NET Core2.0开始，ASP.NET Core内部支持断点续传。 因此只是对FileResult做了一些扩展。 只留下了“Content-Disposition” Inline的一部分。 所有代码都依赖于基础.NET类。
## 如何使用
### .NET Framework
在你的控制器中，你可以像在 `FileResult`一样的方式使用它。
```csharp
using Masuit.Tools.Mvc;
using Masuit.Tools.Mvc.ResumeFileResult;
```
```csharp
private readonly MimeMapper mimeMapper=new MimeMapper(); // 推荐使用依赖注入
public ActionResult ResumeFileResult()
{
var path = Server.MapPath("~/Content/test.mp4");
return new ResumeFileResult(path, mimeMapper.GetMimeFromPath(path), Request);
}
public ActionResult ResumeFile()
{
return this.ResumeFile("~/Content/test.mp4", mimeMapper.GetMimeFromPath(path), "test.mp4");
}
public ActionResult ResumePhysicalFile()
{
return this.ResumePhysicalFile(@"D:/test.mp4", mimeMapper.GetMimeFromPath(@"D:/test.mp4"), "test.mp4");
}
```
### Asp.Net Core
要使用ResumeFileResults，必须在 `Startup.cs`的 `ConfigureServices`方法调用中配置服务：
```csharp
using Masuit.Tools.AspNetCore.ResumeFileResults.Extensions;
```
```csharp
public void ConfigureServices(IServiceCollection services)
{
services.AddResumeFileResult();
}
```
然后在你的控制器中，你可以像在 `FileResult`一样的方式使用它。
点击查看代码
```csharp
using Masuit.Tools.AspNetCore.ResumeFileResults.Extensions;
```
```csharp
private const string EntityTag = "\"TestFile\"";
private readonly IHostingEnvironment _hostingEnvironment;
private readonly DateTimeOffset _lastModified = new DateTimeOffset(2016, 1, 1, 0, 0, 0, TimeSpan.Zero);
///
///
///
///
public TestController(IHostingEnvironment hostingEnvironment)
{
_hostingEnvironment = hostingEnvironment;
}
[HttpGet("content/{fileName}/{etag}")]
public IActionResult FileContent(bool fileName, bool etag)
{
string webRoot = _hostingEnvironment.WebRootPath;
var content = System.IO.File.ReadAllBytes(Path.Combine(webRoot, "TestFile.txt"));
ResumeFileContentResult result = this.ResumeFile(content, "text/plain", fileName ? "TestFile.txt" : null, etag ? EntityTag : null);
result.LastModified = _lastModified;
return result;
}
[HttpGet("content/{fileName}")]
public IActionResult FileContent(bool fileName)
{
string webRoot = _hostingEnvironment.WebRootPath;
var content = System.IO.File.ReadAllBytes(Path.Combine(webRoot, "TestFile.txt"));
var result = new ResumeFileContentResult(content, "text/plain")
{
FileInlineName = "TestFile.txt",
LastModified = _lastModified
};
return result;
}
[HttpHead("file")]
public IActionResult FileHead()
{
ResumeVirtualFileResult result = this.ResumeFile("TestFile.txt", "text/plain", "TestFile.txt", EntityTag);
result.LastModified = _lastModified;
return result;
}
[HttpPut("file")]
public IActionResult FilePut()
{
ResumeVirtualFileResult result = this.ResumeFile("TestFile.txt", "text/plain", "TestFile.txt", EntityTag);
result.LastModified = _lastModified;
return result;
}
[HttpGet("stream/{fileName}/{etag}")]
public IActionResult FileStream(bool fileName, bool etag)
{
string webRoot = _hostingEnvironment.WebRootPath;
FileStream stream = System.IO.File.OpenRead(Path.Combine(webRoot, "TestFile.txt"));
ResumeFileStreamResult result = this.ResumeFile(stream, "text/plain", fileName ? "TestFile.txt" : null, etag ? EntityTag : null);
result.LastModified = _lastModified;
return result;
}
[HttpGet("stream/{fileName}")]
public IActionResult FileStream(bool fileName)
{
string webRoot = _hostingEnvironment.WebRootPath;
FileStream stream = System.IO.File.OpenRead(Path.Combine(webRoot, "TestFile.txt"));
var result = new ResumeFileStreamResult(stream, "text/plain")
{
FileInlineName = "TestFile.txt",
LastModified = _lastModified
};
return result;
}
[HttpGet("physical/{fileName}/{etag}")]
public IActionResult PhysicalFile(bool fileName, bool etag)
{
string webRoot = _hostingEnvironment.WebRootPath;
ResumePhysicalFileResult result = this.ResumePhysicalFile(Path.Combine(webRoot, "TestFile.txt"), "text/plain", fileName ? "TestFile.txt" : null, etag ? EntityTag : null);
result.LastModified = _lastModified;
return result;
}
[HttpGet("physical/{fileName}")]
public IActionResult PhysicalFile(bool fileName)
{
string webRoot = _hostingEnvironment.WebRootPath;
var result = new ResumePhysicalFileResult(Path.Combine(webRoot, "TestFile.txt"), "text/plain")
{
FileInlineName = "TestFile.txt",
LastModified = _lastModified
};
return result;
}
[HttpGet("virtual/{fileName}/{etag}")]
public IActionResult VirtualFile(bool fileName, bool etag)
{
ResumeVirtualFileResult result = this.ResumeFile("TestFile.txt", "text/plain", fileName ? "TestFile.txt" : null, etag ? EntityTag : null);
result.LastModified = _lastModified;
return result;
}
```
以上示例将为您的数据提供“Content-Disposition：attachment”。 当没有提供fileName时，数据将作为“Content-Disposition：inline”提供。
另外，它可以提供 `ETag`和 `LastModified`标头。
```csharp
[HttpGet("virtual/{fileName}")]
public IActionResult VirtualFile(bool fileName)
{
var result = new ResumeVirtualFileResult("TestFile.txt", "text/plain")
{
FileInlineName = "TestFile.txt",
LastModified = _lastModified
};
return result;
}
```
### 推荐项目
基于EntityFrameworkCore和Lucene.NET实现的全文检索搜索引擎：[Masuit.LuceneEFCore.SearchEngine](https://github.com/ldqk/Masuit.LuceneEFCore.SearchEngine "Masuit.LuceneEFCore.SearchEngine")
开源博客系统：[Masuit.MyBlogs](https://github.com/ldqk/Masuit.MyBlogs "Masuit.MyBlogs")
全龄段友好的C#.NET万能工具库，不管你是菜鸟新手还是骨灰级玩家都能轻松上手，这个库包含一些常用的操作类，大都是静态类，加密解密，反射操作，树结构，文件探测，权重随机筛选算法，分布式短id，表达式树，linq扩展，文件压缩，多线程下载，硬件信息，字符串扩展方法，日期时间扩展操作，中国农历，大文件拷贝，图像裁剪，验证码，断点续传，集合扩展、Excel导出等常用封装。
**诸多功能集一身，代码量不到2MB！**
[官网教程](https://www.masuit.tools)
项目开发模式：日常代码积累+网络搜集
⭐⭐⭐喜欢这个项目的话就Star、Fork、Follow素质三连关♂注一下吧⭐⭐⭐
关于本项目，如果你有任何不懂的地方或使用过程中遇到任何问题，可以直接提issue或私信联系我，我会为你提供**完全免费**的技术指导，当然，如果你觉得不好意思接受免费的指导，想适当打赏我也是不会拒绝的！🤣🤣🤣
## 本项目已得到[JetBrains](https://www.jetbrains.com/shop/eform/opensource)的支持！
## Star趋势
## 请注意：
一旦使用本开源项目以及引用了本项目或包含本项目代码的公司因为违反劳动法（包括但不限定非法裁员、超时用工、雇佣童工等）在任何法律诉讼中败诉的，一经发现，本项目作者有权利追讨本项目的使用费（**公司工商注册信息认缴金额的2-5倍作为本项目的授权费**），或者直接不允许使用任何包含本项目的源代码！ `人力外包公司`或 `007公司`需要使用本类库，请联系作者进行商业授权！其他企业或个人可随意使用不受限。007那叫用人，也是废人。8小时工作制才可以让你有时间自我提升，将来有竞争力。反对007，人人有责！
## 建议开发环境
操作系统：Windows 11 23H2及以上版本
开发工具：VisualStudio2022 v17.8及以上版本
SDK：.Net Core 2.1.0及以上**所有版本**
## 安装程序包
### 基础功能包
#### .NET Framework ≥ 4.6.2
```shell
PM> Install-Package Masuit.Tools.Net
```
#### .NET Standard ≥ 2.1 或只想使用一些基本功能
`通用项目推荐首选包`
```shell
PM> Install-Package Masuit.Tools.Abstraction
```
#### .NET Core ≥ 2.1
`.NET Core项目推荐首选包`
```shell
PM> Install-Package Masuit.Tools.Core
```
#### .NET Framework 4.5特供版
请注意：`这是.NET Framework 4.5的专用版本，相比4.6.2及.NET Core的版本，阉割了Redis、HTML、文件压缩、ASP.NET扩展、硬件监测、Session扩展等一些功能。`**如果你的项目版本高于4.6.2，请务必使用上述版本的包，以享受完整的功能体验！**
```shell
PM> Install-Package Masuit.Tools.Net45
```
### 增值包
#### Masuit.Tools.AspNetCore
`AspNetCore项目推荐首选包`
ASP.NET Core Web专用包，包含Masuit.Tools.Core的全部功能，并且增加了一些对ASP.NET Core Web功能的额外支持。
#### Masuit.Tools.Excel
Excel导入导出的专用独立包
#### Masuit.Tools.NoSQL.MongoDBClient
mongodb的封装操作类独立包
## 为工具库注册配置(可选的，按需配置)
工具库需要用到外部配置节，.NET Framework项目配置在web.config/app.config的AppSettings配置节中，.NET Core项目配置在appsettings.json中：
1. EmailDomainWhiteList，邮箱校验需要用到的白名单域名正则表达式，数组形式，每个元素支持正则表达式，若未配置，则不启用邮箱校验白名单，示例: `["^\\w{1,5}@qq.com","^\\w{1,5}@163.com","^\\w{1,5}@gmail.com","^\\w{1,5}@outlook.com"]`
2. EmailDomainBlockList，邮箱校验需要用到的黑名单域名正则表达式，数组形式，每个元素支持正则表达式，且黑名单优先级高于白名单，若未配置，则不启用邮箱校验黑白名单
```csharp
public Startup(IConfiguration configuration)
{
configuration.AddToMasuitTools(); // 若未调用，则默认自动尝试加载appsettings.json
}
```
## 特色功能示例代码
### 在线体验
https://replit.com/@ldqk/MasuitToolsDemo?v=1#main.cs
### 0. 一些创意类型
`DisposableDictionary`：可被Disposable的字典类型，用于存放Value是Disposable类型的数据，用法和普通字典一致
`NullableConcurrentDictionary`/`NullableDictionary`：Key可为null的字典类型，用法和普通字典一致
`ConcurrentHashSet`：并发HashSet，用法和HashSet一致
`ConcurrentLimitedQueue`：定长并发队列，特点是长度是固定的，用法与ConcurrentQueue一致
`ConcurrentHashQueue`：线程安全的唯一队列，特点是元素是唯一的，用法与ConcurrentQueue一致
`LimitedQueue`：定长队列，特点是长度是固定的，用法与Queue一致
`HashQueue`：唯一队列，特点是元素是唯一的，用法与Queue一致
`LargeMemoryStream`：超大内存流，最大可支持1TB数据，推荐当数据流大于2GB时使用，用法与MemoryStream一致
`PooledMemoryStream`：池化内存流，可内存复用，用法与MemoryStream一致，性能比MemoryStream好
`ITree