Masuit.Tools 开源项目安装与使用教程

1. 项目目录结构及介绍

Masuit.Tools 是一个面向全年龄段开发者设计的 C# .NET 万能工具库，它封装了一系列实用的静态类方法，涵盖了加密解密、反射操作、文件处理等多个方面。以下是对项目主要目录结构的简要说明：

Masuit.Tools/
├── Abstractions           # 抽象层，提供了基础的抽象类和接口，便于扩展
├── AspNetCore             # 针对 ASP.NET Core 的特定扩展和功能
├── BenchMarkTest          # 性能测试相关
├── Core                   # 核心功能模块，适用于大多数场景
├── Excel                  # Excel 导入导出相关的功能实现
├── Net45                  # 特别针对 .NET Framework 4.5 的兼容版本
├── NoSQL                  # 包含 MongoDB 客户端操作
├── Tools.sln              # 解决方案文件，包含整个项目的引用和设置
└── ...                    # 更多子目录，包含其他特性模块、测试项目等

每个模块下通常含有对应的源代码文件，而.sln解决方案文件负责组织这些项目。

2. 项目的启动文件介绍

虽然作为一个工具库，并没有传统的启动文件（如 Program.cs），但开发者在集成到自己的应用中时，可能需要关注以下几个关键点：

• 对于 ASP.NET Core 应用，重要的启动文件是 Startup.cs，在这里你可以配置依赖注入和服务，并通过 [configuration].AddToMasuitTools() 方法来集成 Masuit.Tools 的配置。
• 对于非 web 应用，集成通常是通过 NuGet 包管理器命令添加引用并直接调用库中的静态方法。

3. 项目的配置文件介绍

针对 .NET Core 和 .NET 5/6+/NET Core 项目

配置主要位于 appsettings.json 文件中。你需要加入以下配置项（如果需要特定功能的话）：

• EmailDomainWhiteList: 设置邮箱校验的白名单域名，支持正则表达式，多个值使用英文逗号分隔。
• EmailDomainBlockList: 设置邮箱校验的黑名单域名，优先级高于白名单，规则同上。

例如：

{
    "MasuitTools": {
        "EmailDomainWhiteList": "^\\w+@[example].com"
    }
}

针对 .NET Framework 项目

配置位于 web.config 或 app.config 的 <appSettings> 节点内，格式同样如上。

这个项目鼓励按需配置，如果没有特殊需求，你不需要改动这些配置即可开始使用大部分基础功能。但在利用特定如邮件验证等功能时，正确的配置文件设置是非常必要的。

以上就是Masuit.Tools的基本安装和配置指导。确保正确理解和配置你的项目，以便顺利使用这个强大的工具库。记得查阅项目文档和示例代码，以深入了解如何在实际开发中运用它的各项功能。