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
66
Quantum.Framework.Core.StandardLib
Package Description
67
Quantum.Framework.Core.StandardLib
Package Description
68
Quantum.Framework.Core.StandardLib
Package Description
69
Quantum.Framework.Core.StandardLib
Package Description
73
Quantum.Framework.Core.StandardLib
Package Description
75
Quantum.Framework.Core.StandardLib
Package Description
76
Quantum.Framework.Core.StandardLib
Package Description
77
Quantum.Framework.Core.StandardLib
Package Description
79
Quantum.Framework.Core.StandardLib
Package Description
85
Quantum.Framework.Core.StandardLib
Package Description
86
Quantum.Framework.Core.StandardLib
Package Description
87
Quantum.Framework.Core.StandardLib
Package Description
88
Quantum.Framework.Core.StandardLib
Package Description
103
Quantum.Framework.Core.StandardLib
Package Description
146
Quantum.Framework.Core.StandardLib
Package Description
155
Quantum.Framework.Core.StandardLib
Package Description
471

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