MiniExcel 1.34.2

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).

image

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

Get Started

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

Showing the top 20 packages that depend on MiniExcel.

Packages Downloads
Quantum.Framework.Core.StandardLib
Package Description
54
Quantum.Framework.Core.StandardLib
Package Description
55
Quantum.Framework.Core.StandardLib
Package Description
57
Quantum.Framework.Core.StandardLib
Package Description
58
Quantum.Framework.Core.StandardLib
Package Description
59
Quantum.Framework.Core.StandardLib
Package Description
61
Quantum.Framework.Core.StandardLib
Package Description
63
Quantum.Framework.Core.StandardLib
Package Description
64
Quantum.Framework.Core.StandardLib
Package Description
66
Quantum.Framework.Core.StandardLib
Package Description
67
Quantum.Framework.Core.StandardLib
Package Description
69
Quantum.Framework.Core.StandardLib
Package Description
73
Quantum.Framework.Core.StandardLib
Package Description
74
Quantum.Framework.Core.StandardLib
Package Description
77
Quantum.Framework.Core.StandardLib
Package Description
92
Quantum.Framework.Core.StandardLib
Package Description
130
Quantum.Framework.Core.StandardLib
Package Description
135
Quantum.Framework.Core.StandardLib
Package Description
394

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

.NET Framework 4.5

  • No dependencies.

.NET 6.0

  • No dependencies.

.NET Standard 2.0

  • No dependencies.

Version Downloads Last updated
2.0.0-preview.2 15 11/18/2025
2.0.0-preview.1 20 09/02/2025
1.42.0 14 11/19/2025
1.41.4 14 09/20/2025
1.41.3 21 06/24/2025
1.41.2 26 05/24/2025
1.41.1 30 04/28/2025
1.41.0 27 04/29/2025
1.40.1 26 04/22/2025
1.40.0 29 04/11/2025
1.39.0 31 03/25/2025
1.38.0 28 03/16/2025
1.37.0 36 01/28/2025
1.36.1 30 01/28/2025
1.36.0 37 12/27/2024
1.35.0 31 11/24/2024
1.34.2 36 11/25/2024
1.34.1 39 11/29/2024
1.34.0 39 12/02/2024
1.33.0 36 12/02/2024
1.32.1 39 11/29/2024
1.32.0.5-quantumdev 189 07/15/2024
1.32.0.4-quantumdev 144 06/19/2024
1.32.0.3-quantumdev 46 06/18/2024
1.32.0.2-quantumdev 54 06/11/2024
1.32.0.1-quantumdev 41 06/07/2024
1.32.0 32 11/28/2024
1.31.3 44 01/27/2024
1.31.2 120 12/15/2023
1.31.0 36 11/29/2024
1.30.3 35 11/29/2024
1.30.2 41 11/11/2024
1.30.1 33 11/28/2024
1.30.0 35 11/29/2024
1.29.0 45 02/01/2023
1.28.5 35 12/02/2024
1.28.4 42 11/26/2024
1.28.2 34 12/06/2024
1.28.1 38 12/06/2024
1.28.0 38 12/02/2024
1.27.0 39 12/02/2024
1.26.7 40 11/26/2024
1.26.6 35 11/11/2024
1.26.5 34 12/09/2024
1.26.4 35 12/06/2024
1.26.3 40 12/10/2024
1.26.2 41 12/02/2024
1.26.1 38 12/10/2024
1.26.0 33 12/10/2024
1.24.2 42 12/08/2024
1.24.1 41 11/12/2024
1.24.0 30 11/30/2024
1.23.2 35 11/29/2024
1.23.1 35 11/30/2024
1.22.0 37 11/12/2024
0.21.5 31 12/02/2024
0.21.4 38 11/29/2024
0.19.1 36 12/02/2024
0.19.0 37 11/28/2024
0.18.0 39 11/28/2024
0.17.5 31 11/11/2024
0.17.4 36 11/29/2024
0.17.2 33 11/25/2024
0.17.1 37 11/27/2024
0.17.0 39 11/28/2024
0.16.1 37 11/27/2024
0.16.0 33 11/12/2024
0.15.5 36 11/30/2024
0.15.4 36 11/12/2024
0.15.2 39 12/01/2024
0.15.1 39 11/12/2024
0.14.8 36 11/29/2024
0.14.7 33 11/26/2024
0.14.6 36 12/06/2024
0.14.5 32 12/02/2024
0.14.4 36 11/27/2024
0.14.3 39 11/30/2024
0.14.2 36 12/06/2024
0.14.1 43 11/27/2024
0.14.0 38 11/27/2024
0.13.5 39 11/16/2024
0.13.4 37 11/28/2024
0.13.3 36 11/07/2023
0.13.2 38 11/26/2024
0.13.1 37 11/27/2024
0.13.0 36 11/17/2024
0.12.2 37 11/28/2024
0.12.1 31 11/26/2024
0.12.0-beta 42 11/27/2024
0.11.1 36 12/14/2024
0.11.0 40 11/28/2024
0.10.3 42 11/11/2024
0.10.2 37 11/30/2024
0.10.1 41 11/12/2024
0.10.0 33 12/11/2024
0.9.1 38 11/11/2024
0.9.0 37 12/11/2024
0.8.0 41 12/14/2024
0.7.0 36 12/14/2024
0.6.0 40 12/11/2024
0.5.0 34 11/27/2024
0.4.0 36 11/24/2024
0.3.0 33 11/26/2024
0.2.3 32 11/27/2024
0.2.2 32 11/27/2024
0.2.1 32 11/25/2024
0.2.0 37 11/27/2024
0.1.0-preview 34 11/12/2024
0.0.7-beta 31 11/11/2024
0.0.6-beta 39 11/12/2024
0.0.5-beta 31 11/26/2024
0.0.4-beta 37 11/14/2024
0.0.3-beta 32 11/27/2024
0.0.2-beta 36 11/12/2024
0.0.1-beta 44 11/12/2024