{首页主词},&

什么是MiniExcel?

MiniExcel是.Net基金會(huì)旗下的項(xiàng)目，是一款簡(jiǎn)單、高效避免OOM（Out of Memory）的.NET處理Excel查、寫(xiě)、填充數(shù)據(jù)工具。

MiniExcel特點(diǎn)

與其他Excel處理框架相比，MiniExcel具有如下特點(diǎn)：
低內(nèi)存耗用，避免OOM、頻繁 Full GC 情況
支持即時(shí)操作每行數(shù)據(jù)
兼具搭配 LINQ 延遲查詢特性，能辦到低消耗、快速分頁(yè)等復(fù)雜查詢
輕量，不需要安裝 Microsoft Office、COM+，DLL小于150KB
簡(jiǎn)便操作的 API 風(fēng)格

Excel操作性能比較

以下是MiniExcel官方列出的與其他Excel框架的的性能比較。主要分為讀取和寫(xiě)入，如下所示：

1. 導(dǎo)入和查詢比較

邏輯 : 以 Test1,000,000x10.xlsx 做基準(zhǔn)與主流框架做性能測(cè)試，總共 1,000,000 行 * 10 列筆 "HelloWorld"，文件大小 23 MB

2. 導(dǎo)出和創(chuàng)建Excel

邏輯 : 創(chuàng)建1千萬(wàn)筆 "HelloWorld"

通過(guò)上述對(duì)比，可以發(fā)現(xiàn)，MiniExcel無(wú)論在讀取，還是寫(xiě)入，性能都挺不錯(cuò)，值得學(xué)習(xí)。

MinExcel安裝

在Visual Studio 2022中，可以通過(guò)Nuget包管理器進(jìn)行安裝，當(dāng)前最新版本為v1.41.1，如下所示：

MinExcel讀取

MiniExcel最強(qiáng)大之處，將Excel中的列和模型中的屬性名，進(jìn)行自動(dòng)匹配，進(jìn)而實(shí)現(xiàn)ORM，減少手動(dòng)匹配的繁瑣操作。如下所示：

當(dāng)前有一個(gè)Persons.xlsx的Excel，如下所示：

我們創(chuàng)建一個(gè)Person的模型類，如下所示：

namespace DemoMiniExcel{    public class Person    {        public int ID { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }    }}

然后通過(guò)MiniExcel的Query方法進(jìn)行查詢，Query方法返回值支持泛型操作，傳入指定的模型類對(duì)象，如下所示：

namespace DemoMiniExcel{    internal class Program    {        static void Main(string[] args)        {            string excel = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory), "Person.xlsx");            var rows = MiniExcel.Query<Person>(excel).ToList();            if (rows.Count > 0)            {                foreach (var item in rows)                {                    Console.WriteLine($"ID={item.ID},Name={item.Name},Age={item.Age}");                }            }            Console.WriteLine("Hello, World!");        }    }}

測(cè)試示例，如下所示：

在上述示例中采用MiniExcel的Query方法只是其中一種方式，還可以通過(guò)MiniExcel對(duì)Stream的擴(kuò)展方法Query進(jìn)行操作，如下所示：

namespace DemoMiniExcel{    internal class Program    {        static void Main(string[] args)        {            string excel = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory), "Person.xlsx");            using (var stream = File.OpenRead(excel))            {                var rows = stream.Query<Person>().ToList();                if (rows.Count > 0)                {                    foreach (var item in rows)                    {                        Console.WriteLine($"ID={item.ID},Name={item.Name},Age={item.Age}");                    }                }            }            Console.WriteLine("Hello, World!");        }    }}

實(shí)例運(yùn)行效果和上面一樣，不再贅述。

MinExcel寫(xiě)入

MiniExcel支持將對(duì)象數(shù)據(jù)寫(xiě)入到Excel，可以通過(guò)MiniExcel提供的SaveAs方法，將對(duì)象數(shù)據(jù)寫(xiě)入Excel，如下所示：

string excel = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory), "Person2.xlsx");var persons = new List<Person>();for (int i = 0; i < 10; i++){    persons.Add(new Person()    {        ID = i,        Name = "A" + i.ToString(),        Age = 20 + i,    });}MiniExcel.SaveAs(excel, persons);

MiniExcel寫(xiě)入的Excel，默認(rèn)還自帶格式，如下所示：

同時(shí)MiniExcel，還支持Stream的讀寫(xiě)方式創(chuàng)建Excel，如下所示：

string excel = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory), "Person3.xlsx");var persons = new List<Person>();for (int i = 0; i < 10; i++){    persons.Add(new Person()    {        ID = i,        Name = "A" + i.ToString(),        Age = 20 + i,    });}using (var stream = File.Create(excel)){    stream.SaveAs(persons);}

實(shí)例運(yùn)行后，導(dǎo)出的Excel效果和上面一樣，不再贅述。

參考文檔

本文主要介紹MiniExcel的簡(jiǎn)單用途，關(guān)于更多內(nèi)容，請(qǐng)參考官方文檔：https://gitee.com/dotnetchina/MiniExcel

閱讀原文：原文鏈接

該文章在 2025/6/23 15:11:19 編輯過(guò)

關(guān)鍵字查詢

Excel