YellowJExcel 1.0.1

YellowJExcel

高性能 .NET Excel 读写库，兼容 MiniExcel 设计思想，支持灵活样式与列控制，适合大数据量高效导入导出。

特性

• 🚀 极致性能：底层结合 MiniExcel（高性能流式读写）与 ClosedXML（灵活样式），兼顾速度与美观。
• 🧩 简洁 API：一行代码即可完成 Excel 的读写。
• 🎨 丰富样式：支持、列/行背景色、条件格式、隐藏列、列顺序等。
• 📄 Sheet 操作：支持多 Sheet 读写。
• 📝 实体映射：基于实体对象和 List 进行读写，类型安全。
• 🛠️ 灵活配置：导出时可随意设置导出列、隐藏列、列顺序、列颜色、条件颜色等。
• 🏆 对比优势：兼容 MiniExcel 语法，样式能力更强。

安装

1. 安装 NuGet 包：

   dotnet add packageYellowJExcel
   

2. 引用命名空间：

   using YellowJExcel;
   

快速开始

1. 定义实体类

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string Email { get; set; }
}

2. 读取 Excel 到 List

var users = YellowJExcel.Read<User>("input.xlsx");
// 可指定 sheet 名
var usersSheet2 = YellowJExcel.Read<User>("input.xlsx", "Sheet2");

3. 导出 List 到 Excel（默认橘黄色表头）

YellowJExcel.Write("output.xlsx", users);

3.1 导出 List 到 Excel（多个Sheet工作表）

var data1 = new List<YourClass> { /* 数据1 */ };
var data2 = new List<YourClass> { /* 数据2 */ };

var config1 = new ExcelConfig<YourClass> { SheetName = "工作表1" };
var config2 = new ExcelConfig<YourClass> { SheetName = "工作表2" };

var sheets = new Dictionary<List<YourClass>, ExcelConfig<YourClass>>
{
    { data1, config1 },
    { data2, config2 }
};

YellowJExcel.Write("output.xlsx", sheets);

这个实现保持了原有的所有功能，同时支持多工作表写入，每个工作表可以有自己独立的配置。

4. 高级导出配置

var config = new ExcelConfig<User>
{
    SheetName = "用户数据",
    ExcludedColumns = new HashSet<string> { "Email" }, // 不导出 Email 列
    HiddenColumns = new HashSet<string> { "Id" },      // 隐藏 Id 列
    ColumnOrder = new List<string> { "Name", "Age", "Id" }, // 自定义列顺序
    ColumnColors = new Dictionary<string, string>
    {
        ["Age"] = "#FFFACD" // Age 列背景色为柠檬黄
    }
};
// 条件样式：未成年人行高亮
config.ConditionalRules.Add((u => u.Age < 18, "#FFB6C1")); // 粉色

YellowJExcel.Write("output.xlsx", users, config);

API 说明

YellowJExcel.Read<T>

List<T> YellowJExcel.Read<T>(string filePath, string sheetName = null)

• filePath: Excel 文件路径
• sheetName: 工作表名（可选）
• 返回: List<T> 实体对象列表

YellowJExcel.Write<T>

void YellowJExcel.Write<T>(string filePath, List<T> data, ExcelConfig<T> config = null)

• filePath: 输出文件路径
• data: 数据列表
• config: 导出配置（可选）

ExcelConfig<T> 配置项

常用颜色十六进制代码表

说明：预览仅供参考，实际颜色以 Excel/前端渲染为准。可将上述任意十六进制代码（如 #FFA500）用于 ExcelConfig 的颜色配置。

贡献与反馈

欢迎提交 Issue 或 PR 参与改进！
如有建议或问题请联系作者。

License

本项目遵循 MIT 协议，MiniExcel/ClosedXML 依赖遵循各自协议。

特别感谢 MiniExcel 和 ClosedXML 项目为 .NET 社区带来的卓越 Excel 处理能力！