当前位置:

首页 > 编程开发 > C#中使用MiniExcel读写.xlsx文件的代码实现

C#中使用MiniExcel读写.xlsx文件的代码实现

MiniExcel是一款轻量级、无Office依赖的.NET库,直接操作.xlsx文件。提供基础读写、分批写入优化、模板生成报表、样式设置及合并单元格读取等功能,性能高效,内存占用低,易于集成,支持导出数据表,适合中小数据量的Excel处理场景。

本文目录

    不得不说,在报表这件事上,Excel几乎是个绕不过去的坎儿。以前很多人处理Excel文件,第一反应就是Microsoft.Office.Interop——那套方案你得先装Office,而且进程管理稍有不慎就容易出幺蛾子,算是历史遗留的“老办法”了。今天聊的MiniExcel就清爽很多,库文件不到1MB,核心思路是不依赖Office环境,直接操作.xlsx文件底层的ZIP压缩包,读写都在.NET Core或.NET Framework上跑得挺溜。

    C#中使用MiniExcel读写.xlsx文件的代码实现

    接下来,我们从最基础的读写开始,再到写入优化、样式设置,一步步把常见的操作场景串起来。

    代码实现

    1. 安装与基础读写

    安装方式就是一行命令的事:

    dotnet add package MiniExcel

    读取Excel文件,MiniExcel提供了几种很直观的方式。可以直接把整个sheet读成List,也可以指定sheet名称,还可以读成DataTable方便后面做筛选。

    using MiniExcelLibs;
    // ===== 读 Excel =====
    public void ReadExcel()
    {
        // 读取整个 sheet
        var rows = MiniExcel.Query("report.xlsx").ToList();
        // 读取指定 sheet
        var rows2 = MiniExcel.Query("report.xlsx", sheetName: "Sheet2").ToList();
        // 读取为 DataTable(便于筛选)
        var dt = MiniExcel.QueryAsDataTable("report.xlsx");
        foreach (DataRow row in dt.Rows)
        {
            Console.WriteLine($"{row["DeviceId"]} - {row["Value"]}");
        }
    }

    写Excel也一样简洁,直接把List丢进去就行,连表头都会自动映射。

    // ===== 写 Excel =====
    public void WriteSimpleExcel()
    {
        var devices = new[]
        {
            new { DeviceId = "INJ001", Temperature = 85.5, Pressure = 1.2 },
            new { DeviceId = "INJ002", Temperature = 82.3, Pressure = 1.1 }
        };
        // 最简单写法:List 直接写
        MiniExcel.Sa veAs("output.xlsx", devices);
        // 指定 sheet 名
        MiniExcel.Sa veAs("output.xlsx", devices, sheetName: "生产数据");
    }

    2. 写入优化:分批写入大文件

    这里有个常见的坑——MiniExcel默认会把所有数据一股脑加载到内存里。数据量小的时候没什么感觉,但一旦到了几十万行,内存就有点吃不消了。

    解决办法也不复杂:分批写入。每次处理5000条,第一批负责创建文件并写入表头,后面批次通过AppendExcel追加数据即可。

    public void WriteLargeFile(string filePath, IEnumerable rows)
    {
        var batchSize = 5000;
        var batch = new List();
    
        using (var stream = File.Create(filePath))
        {
            bool firstBatch = true;
    
            foreach (var row in rows)
            {
                batch.Add(row);
    
                if (batch.Count >= batchSize)
                {
                    if (firstBatch)
                    {
                        // 第一批:创建文件 + 写入表头
                        stream.Seek(0, SeekOrigin.Begin);
                        MiniExcel.Sa veAs(stream, batch, printHeader: true);
                        firstBatch = false;
                    }
                    else
                    {
                        // 后续批次:追加到已有 sheet(通过 sheetName)
                        MiniExcel.AppendExcel(stream, batch, sheetName: "Data");
                    }
                    batch.Clear();
                }
            }
    
            // 处理剩余数据
            if (batch.Count > 0)
            {
                if (firstBatch)
                    MiniExcel.Sa veAs(stream, batch, printHeader: true);
                else
                    MiniExcel.AppendExcel(stream, batch, sheetName: "Data");
            }
        }
    }

    3. 使用模板生成报表

    很多业务场景下,报表的格式是固定的,只是每次往里面填数据。MiniExcel支持基于模板生成报表——你先把模板Excel准备好,包括标题、列头、合并单元格等格式信息,然后通过Sa veAsByTemplate把数据注入进去。

    // 报表模板(template.xlsx)包含:
    // - A1: 标题(已合并单元格)
    // - A3: 列头(DeviceId, Timestamp, Temperature...)
    // - A4 以下:数据区(空着,等我们填充)
    
    public void GenerateFromTemplate()
    {
        string templatePath = "template.xlsx";
        string outputPath = "report_20240421.xlsx";
    
        // 1. 复制模板
        File.Copy(templatePath, outputPath, overwrite: true);
    
        // 2. 读取模板内容(不覆盖格式)
        var template = MiniExcel.QueryAsDataTable(outputPath);
    
        // 3. 准备数据
        var data = GetProductionData(); // List
    
        // 4. 写入数据(从 A4 开始)
        MiniExcel.Sa veAsByTemplate(outputPath, new
        {
            Title = "2024年4月21日 生产报表",
            GenerateDate = DateTime.Now.ToString("yyyy-MM-dd HH:mm"),
            Data = data  // 这个 key 会对应模板中的 Data 区域
        });
    }

    4. 样式设置

    样式的控制上,MiniExcel提供了一些基础能力,比如设置列宽、列名、数字格式。如果需要更深入的样式控制(比如行高、背景色、字体),那就得借助底层操作了。

    public void WriteWithStyle()
    {
        var rows = new List>
        {
            new Dictionary { ["DeviceId"] = "INJ001", ["Value"] = 85.5 },
            new Dictionary { ["DeviceId"] = "INJ002", ["Value"] = 82.3 }
        };
    
        // 设置列配置
        var columns = new Dictionary
        {
            ["DeviceId"] = new MiniExcelColumnAttribute { Name = "设备编号", Width = 15 },
            ["Value"] = new MiniExcelColumnAttribute { Name = "测量值", Width = 12, Format = "0.00" }
        };
    
        // 写入并设置列宽
        MiniExcel.Sa veAs("styled.xlsx", rows, configurations: columns);
    }

    如果确实需要更精细的样式控制,技术判断是:直接用MiniExcel做简单的样式配置,遇到复杂场景时果断引入ClosedXML或EPPlus来配合使用。

    // 自定义样式(需要底层操作)
    public void WriteWithCustomStyle(string filePath)
    {
        var config = new MiniExcelConfiguration
        {
            SheetName = "Report"
        };
    
        using var stream = File.Create(filePath);
        stream.Seek(0, SeekOrigin.Begin);
    
        // MiniExcel 支持通过 .xlsx 的 shared strings 和 styles.xml
        // 完整样式控制建议用 ClosedXML 或 EPPlus
    }

    5. 读取时处理合并单元格

    合并单元格在真实业务数据中很常见,但读取起来有点麻烦。MiniExcel默认会把合并单元格的值复制到每一行,如果你想精准识别哪些区域是合并的,需要手动解析单元格的MergeCount信息。

    public void ReadMergedCells()
    {
        var cells = MiniExcel.GetCells("merged.xlsx").ToList();
    
        var mergedRanges = cells
            .Where(c => c.MergeCount > 0)
            .Select(c => new
            {
                c.Value,
                StartRow = c.Row,
                EndRow = c.Row + c.MergeCount - 1,
                StartCol = c.Column,
                EndCol = c.Column + 1  // 简化:默认横向合并
            })
            .ToList();
    
        foreach (var m in mergedRanges)
        {
            Console.WriteLine($"合并区域: {m.Value} ({m.StartRow}-{m.EndRow})");
        }
    }

    总的来说,MiniExcel在轻量级、无Office依赖的Excel处理场景里,确实是值得考虑的选择。如果数据量不大、不需要复杂样式,用它就够了;如果需要更精致的报表设计,那配合ClosedXML或EPPlus做样式的深层控制,才是更成熟的实践路径。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Excel
    相关文章 更多
    Excel怎么跨表引用数据 引用功能与工作表链接方法
    Excel怎么跨表引用数据 引用功能与工作表链接方法

    Excel跨表引用数据,可以在目标单元格输入等号,再点击源工作表标签和需要引用的单元格,按Enter完成。公式通常是“工作表名!单元格地址”;需要向下复制时,还要检查相对引用与绝对引用是否符合需求。

    Excel如何转换文本为日期 分列功能与格式设置方法
    Excel如何转换文本为日期 分列功能与格式设置方法

    Excel把文本转换为日期,可以选中日期列,进入“数据—分列”,保持每条日期不被拆开,在最后一步选择“日期”并指定YMD、DMY或MDY顺序。完成解析后,再设置日期显示格式,并抽查年月日,不能只改显示格式就认为转换成功。

    Excel怎么批量填充序号 填充功能与序列生成解决方法
    Excel怎么批量填充序号 填充功能与序列生成解决方法

    Excel批量填充序号,可以先输入1和2,选中这两格,再拖动右下角填充柄向下延续。需要一次生成较多序号时,进入“开始—填充—序列”,选择列、等差序列、步长1,并设置终止值即可。

    Excel如何生成数据透视表 插入功能与字段拖拽方法
    Excel如何生成数据透视表 插入功能与字段拖拽方法

    Excel生成数据透视表,先选中带有字段标题的明细区域,点击“插入—数据透视表”,确认数据源并选择放置位置。创建后把分类字段拖到“行”或“列”,把金额、数量拖到“值”,再检查求和方式与汇总结果。

    Excel怎么合并多个表格 数据功能与Power Query方法
    Excel怎么合并多个表格 数据功能与Power Query方法

    Excel合并多个结构相同的表格,可以在Windows桌面版进入“数据—获取数据—从文件—从文件夹”,选择源文件夹,再用Power Query合并并转换数据。若已经把各张表建立为查询,则使用“追加查询”把记录纵向汇总,检查字段与类型后加载结果。

    Excel如何保护工作表 审阅功能与密码设置解决方法
    Excel如何保护工作表 审阅功能与密码设置解决方法

    Excel保护工作表,可以先解除需要填写区域的锁定,再点击“审阅—保护工作表”,设置取消保护密码和允许操作并确认。这样可以保留录入区域,同时限制公式、表头等单元格被随意修改;需要调整设置时,先取消工作表保护。

    Excel怎么打印每页表头 页面布局功能与打印标题方法
    Excel怎么打印每页表头 页面布局功能与打印标题方法

    Excel每页打印表头,可以进入“页面布局—打印标题”,在“工作表”页签的“顶端标题行”中选择表头所在的整行,例如第一行填写$1:$1。保存后打开打印预览,并翻到第二页确认表头已重复出现。

    Excel如何删除重复项 数据工具功能与去重解决方法
    Excel如何删除重复项 数据工具功能与去重解决方法

    Excel删除重复项,先选中完整数据区域,点击“数据—删除重复项”,确认是否包含标题,再勾选用于判断重复的列并确定。操作会删除所选区域内的重复记录,建议先备份,并用业务编号、日期等字段确定真正的重复标准。

    Excel怎么设置条件格式 突出显示功能与规则设置方法
    Excel怎么设置条件格式 突出显示功能与规则设置方法

    Excel设置条件格式,先选中数据区域,再点击“开始—条件格式—突出显示单元格规则”,选择大于、小于或重复值等条件,填写判断值并设置样式。以后需要修改范围或取消规则,可进入“管理规则”检查条件与“应用于”区域。

    Excel如何拆分单元格内容 分列功能与分隔符设置方法
    Excel如何拆分单元格内容 分列功能与分隔符设置方法

    Excel拆分单元格内容,可以选中需要处理的一列,进入“数据—分列”,选择“分隔符号”,再勾选逗号、空格或自定义分隔符。确认预览、各列数据格式和目标位置后完成,操作前要给右侧结果预留空列。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。