MiniExcel 1.35.0

Prefix Reserved

.NET 8.0 .NET Standard 2.0 .NET Framework 4.5

dotnet add package MiniExcel --version 1.35.0

NuGet\Install-Package MiniExcel -Version 1.35.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="MiniExcel" Version="1.35.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add MiniExcel --version 1.35.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: MiniExcel, 1.35.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install MiniExcel as a Cake Addin
#addin nuget:?package=MiniExcel&version=1.35.0

// Install MiniExcel as a Cake Tool
#tool nuget:?package=MiniExcel&version=1.35.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

This project is part of the .NET Foundation and operates under their code of conduct.

Introduction

MiniExcel is simple and efficient to avoid OOM's .NET processing Excel tool.

At present, most popular frameworks need to load all the data into the memory to facilitate operation, but it will cause memory consumption problems. MiniExcel tries to use algorithm from a stream to reduce the original 1000 MB occupation to a few MB to avoid OOM(out of memory).

Features

Low memory consumption, avoid OOM (out of memory) and full GC
Support real-time operation of each row of data
Support LINQ deferred execution, it can do low-consumption, fast paging and other complex queries
Lightweight, without Microsoft Office installed, no COM+, DLL size is less than 150KB
Easy API style to read/write/fill excel

Installation

You can install the package from NuGet

Release Notes

Please Check Release Notes

TODO

Please Check TODO

Performance

Benchmarks logic can be found in MiniExcel.Benchmarks , and test cli

dotnet run -p .\benchmarks\MiniExcel.Benchmarks\ -c Release -f netcoreapp3.1 -- -f * --join

Output from the latest run is :

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19042
Intel Core i7-7700 CPU 3.60GHz (Kaby Lake), 1 CPU, 8 logical and 4 physical cores
  [Host]     : .NET Framework 4.8 (4.8.4341.0), X64 RyuJIT
  Job-ZYYABG : .NET Framework 4.8 (4.8.4341.0), X64 RyuJIT
IterationCount=3  LaunchCount=3  WarmupCount=3

Benchmark History : Link

Import/Query Excel

Logic : Test1,000,000x10.xlsx as performance test basic file, 1,000,000 rows * 10 columns "HelloWorld" cells, 23 MB file size

Library	Method	Max Memory Usage	Mean
MiniExcel	'MiniExcel QueryFirst'	0.109 MB	0.0007264 sec
ExcelDataReader	'ExcelDataReader QueryFirst'	15.24 MB	10.66421 sec
MiniExcel	'MiniExcel Query'	17.3 MB	14.17933 sec
ExcelDataReader	'ExcelDataReader Query'	17.3 MB	22.56508 sec
Epplus	'Epplus QueryFirst'	1,452 MB	18.19801 sec
Epplus	'Epplus Query'	1,451 MB	23.64747 sec
OpenXmlSDK	'OpenXmlSDK Query'	1,412 MB	52.00327 sec
OpenXmlSDK	'OpenXmlSDK QueryFirst'	1,413 MB	52.34865 sec
ClosedXml	'ClosedXml QueryFirst'	2,158 MB	66.18897 sec
ClosedXml	'ClosedXml Query'	2,184 MB	191.43412 sec

Export/Create Excel

Logic : create a total of 10,000,000 "HelloWorld" excel

Library	Method	Max Memory Usage	Mean
MiniExcel	'MiniExcel Create Xlsx'	15 MB	11.53181 sec
Epplus	'Epplus Create Xlsx'	1,204 MB	22.50971 sec
OpenXmlSdk	'OpenXmlSdk Create Xlsx'	2,621 MB	42.47399 sec
ClosedXml	'ClosedXml Create Xlsx'	7,141 MB	140.93992 sec

Documents

https://github.com/mini-software/MiniExcel

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 was computed.
.NET Framework	net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 4.5
- No dependencies.
.NETStandard 2.0
- No dependencies.
net8.0
- No dependencies.

NuGet packages (104)

Showing the top 5 NuGet packages that depend on MiniExcel:

Package	Downloads
GuoKun.CPS 国坤CPS库	188.5K
DH.MiniExcel DH框架的Excel处理库。基于https://github.com/mini-software/MiniExcel	109.3K
NF.Utilities 公共类库,增加DataTable转excel	103.7K
BootstrapBlazor.TableExport Bootstrap UI components extensions of export	73.1K
TXQ.Utils Package Description	59.6K

GitHub repositories (9)

Showing the top 5 popular GitHub repositories that depend on MiniExcel:

Repository	Stars
Scighost/Starward Game Launcher for miHoYo - 米家游戏启动器	3.5K
dotnetcore/BootstrapBlazor Bootstrap Blazor is an enterprise-level UI component library based on Bootstrap and Blazor.	2.7K
dotnetcore/Magicodes.IE Import and export general library, support Dto import and export, template export, fancy export and dynamic export, support Excel, Csv, Word, Pdf and Html.	2.1K
izhaorui/Zr.Admin.NET 🎉ZR.Admin.NET是一款前后端分离的、跨平台基于RBAC的通用权限管理后台。ORM采用SqlSugar。前端采用Vue、AntDesign，支持多租户、缓存、任务调度、支持统一异常处理、接口限流、支持一键生成前后端代码，支持动态国际化翻译(Vue3)，等诸多黑科技，代码简洁易懂、易扩展让开发更简单、更通用。	971
xunkong/xunkong 记录旅途中发生的事	938

Version	Downloads	Last updated
1.35.0	14,227	11/9/2024
1.34.2	88,657	9/14/2024
1.34.1	74,595	8/10/2024
1.34.0	51,093	7/21/2024
1.33.0	46,571	7/7/2024
1.32.1	99,662	5/16/2024
1.32.0	17,149	5/12/2024
1.31.3	392,698	12/27/2023
1.31.2	589,034	8/10/2023
1.31.0	234,418	5/28/2023
1.30.3	88,704	5/1/2023
1.30.2	428,521	2/21/2023
1.30.1	34,270	2/7/2023
1.30.0	190,267	12/27/2022
1.29.0	185,780	11/9/2022
1.28.5	19,398	10/30/2022
1.28.4	3,068	10/29/2022
1.28.2	3,053	10/29/2022
1.28.1	24,921	10/22/2022
1.28.0	67,853	9/19/2022
1.27.0	3,826	9/18/2022
1.26.7	11,082	9/9/2022
1.26.6	10,570	9/4/2022
1.26.5	293,554	6/30/2022
1.26.4	6,647	6/26/2022
1.26.3	227,300	6/7/2022
1.26.2	194,641	4/21/2022
1.26.1	10,423	4/17/2022
1.26.0	218,426	4/12/2022
1.24.2	3,362	3/17/2022
1.24.1	4,902	3/15/2022
1.24.0	14,952	3/9/2022
1.23.2	7,474	3/4/2022
1.23.1	226,041	2/14/2022
1.22.0	3,328	2/12/2022
0.21.5	32,013	2/7/2022
0.21.4	8,473	1/27/2022
0.19.1	277,671	11/15/2021
0.19.0	12,967	10/21/2021
0.18.0	16,409	9/13/2021
0.17.5	247,451	8/20/2021
0.17.4	5,134	8/17/2021
0.17.2	252,345	6/30/2021
0.17.1	6,288	6/23/2021
0.17.0	6,056	6/21/2021
0.16.1	4,589	6/19/2021
0.16.0	3,326	6/19/2021
0.15.5	4,944	6/13/2021
0.15.4	3,500	6/8/2021
0.15.2	10,133	5/20/2021
0.15.1	3,249	5/19/2021
0.14.8	3,707	5/18/2021
0.14.7	3,521	5/17/2021
0.14.6	4,709	5/13/2021
0.14.5	3,659	5/12/2021
0.14.4	3,259	5/12/2021
0.14.3	4,785	5/10/2021
0.14.2	3,243	5/10/2021
0.14.1	4,651	5/7/2021
0.14.0	3,327	5/7/2021
0.13.5	4,916	4/30/2021
0.13.4	5,306	4/26/2021
0.13.3	5,457	4/22/2021
0.13.2	4,956	4/20/2021
0.13.1	3,404	4/18/2021
0.13.0	3,209	4/16/2021
0.12.2	3,114	4/15/2021
0.12.1	3,028	4/14/2021
0.12.0-beta	2,249	4/13/2021
0.11.1	4,549	4/9/2021
0.11.0	3,131	4/8/2021
0.10.3	3,112	4/6/2021
0.10.2	3,061	4/6/2021
0.10.1	3,103	4/4/2021
0.10.0	3,087	4/2/2021
0.9.1	3,133	4/1/2021
0.9.0	3,033	4/1/2021
0.8.0	3,311	3/29/2021
0.7.0	3,093	3/28/2021
0.6.0	3,101	3/26/2021
0.5.0	3,057	3/26/2021
0.4.0	3,075	3/25/2021
0.3.0	3,042	3/21/2021
0.2.3	3,158	3/20/2021
0.2.2	3,388	3/18/2021
0.2.1	3,291	3/17/2021
0.2.0	3,327	3/15/2021
0.1.0-preview	2,431	3/15/2021
0.0.7-beta	2,418	3/14/2021
0.0.6-beta	2,447	3/14/2021
0.0.5-beta	2,547	3/14/2021
0.0.4-beta	2,446	3/14/2021
0.0.3-beta	2,414	3/13/2021
0.0.2-beta	2,371	3/4/2021
0.0.1-beta	2,361	3/3/2021

Please Check [Release Notes](https://github.com/mini-software/MiniExcel/tree/master/docs)