VOOZH about

URL: https://www.nuget.org/packages/MiniExcel/

⇱ NuGet Gallery | MiniExcel 1.44.1



👁 Image
 MiniExcel 1.44.1

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package MiniExcel --version 1.44.1
 
 
NuGet\Install-Package MiniExcel -Version 1.44.1
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.44.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MiniExcel" Version="1.44.1" />
 


 Directory.Packages.props
 

 

 
<PackageReference Include="MiniExcel" />
 


 Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MiniExcel --version 1.44.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support. 
#r "nuget: MiniExcel, 1.44.1"
#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. 
#:package MiniExcel@1.44.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MiniExcel&version=1.44.1
 


 Install as a Cake Addin
 

 

 
#tool nuget:?package=MiniExcel&version=1.44.1
 


 Install as a Cake Tool
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).

👁 image

Features

  • Low memory consumption, avoid OOM (out of memory) and full GC
  • Supports real time operation of each row of data
  • Supports 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 400KB
  • Easy API style to read/write/fill excel

Get Started

Installation

You can install the package from NuGet

Release Notes

Please Check

TODO

Please Check TODO

Performance

The code for the benchmarks can be found in MiniExcel.Benchmarks. To run all the benchmarks use:

dotnet run -project .\benchmarks\MiniExcel.Benchmarks -c Release -f net9.0 -filter * --join

Hardware and settings used are the following:

BenchmarkDotNet v0.15.0, Linux Ubuntu 24.04.2 LTS (Noble Numbat)
AMD EPYC 7763, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.300
 [Host] : .NET 9.0.5 (9.0.525.21509), X64 RyuJIT AVX2
 ShortRun : .NET 9.0.5 (9.0.525.21509), X64 RyuJIT AVX2
Import/Query Excel

The file used to test performance is Test1,000,000x10.xlsx, a 32MB document containing 1,000,000 rows * 10 columns whose cells are filled with the string "HelloWorld".

Method Mean StdDev Error Gen0 Gen1 Gen2 Allocated
'MiniExcel QueryFirst' 63.70 μs 0.337 μs 6.144 μs 2.9297 2.7669 - 49.67 KB
'ExcelDataReader QueryFirst' 5,010,679.51 μs 53,245.186 μs 971,390.400 μs 105000.0000 333.3333 - 1717272.56 KB
'MiniExcel Query' 9,172,286.91 μs 12,805.326 μs 233,616.824 μs 448500.0000 4666.6667 - 7327883.36 KB
'ExcelDataReader Query' 10,609,617.09 μs 29,055.953 μs 530,088.745 μs 275666.6667 68666.6667 - 4504691.87 KB
'Epplus QueryFirst' 13,770,656.24 μs 45,909.809 μs 837,565.827 μs 174333.3333 88833.3333 4333.3333 3700587.76 KB
'Epplus Query' 19,257,306.83 μs 63,117.956 μs 1,151,506.486 μs 452333.3333 90500.0000 5333.3333 8223933.16 KB
'ClosedXml Query' 31,070,263.83 μs 342,973.671 μs 6,257,116.502 μs 401666.6667 104166.6667 3333.3333 6822559.68 KB
'ClosedXml QueryFirst' 31,141,877.48 μs 21,006.538 μs 383,237.459 μs 402166.6667 104833.3333 3833.3333 6738357.8 KB
'OpenXmlSDK QueryFirst' 31,750,686.63 μs 263,328.569 μs 4,804,093.357 μs 374666.6667 374500.0000 3166.6667 6069266.96 KB
'OpenXmlSDK Query' 32,919,119.46 μs 411,395.682 μs 7,505,388.691 μs 374666.6667 374500.0000 3166.6667 6078467.83 KB
Export/Create Excel

Logic: create a total of 10,000,000 "HelloWorld" cells Excel document

Method Mean StdDev Error Gen0 Gen1 Gen2 Allocated
'MiniExcel Create Xlsx' 4.427 s 0.0056 s 0.1023 s 251666.6667 1833.3333 1666.6667 3.92 GB
'OpenXmlSdk Create Xlsx by DOM mode' 22.729 s 0.1226 s 2.2374 s 307000.0000 306833.3333 3833.3333 6.22 GB
'ClosedXml Create Xlsx' 22.851 s 0.0190 s 0.3473 s 195500.0000 54500.0000 4166.6667 4.48 GB
'Epplus Create Xlsx' 23.027 s 0.0088 s 0.1596 s 89000.0000 17500.0000 6000.0000 2.51 GB

Warning: these results may be outdated. You can find the benchmarks for the latest release here.

Documents

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

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

  • net10.0

    • No dependencies.

  • net8.0

    • No dependencies.

  • net9.0

    • No dependencies.

NuGet packages (184)

Showing the top 5 NuGet packages that depend on MiniExcel:

Package Downloads
GuoKun.CPS

国坤CPS库
BootstrapBlazor.TableExport

Bootstrap UI components extensions of export
Dynamicweb.DataIntegration.Providers.ExcelProvider

Excel Provider
DH.MiniExcel

基于DH框架的Excel处理库。基于https://github.com/mini-software/MiniExcel
Wologic.SYS.Application

公司内部自用

GitHub repositories (17)

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

Repository Stars
Scighost/Starward
Game Launcher for miHoYo - 米家游戏启动器
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.
izhaorui/Zr.Admin.NET
🎉ZR.Admin.NET是一款前后端分离的、跨平台基于RBAC的通用权限管理后台。ORM采用SqlSugar。前端采用Vue、AntDesign，支持多租户、缓存、任务调度、支持统一异常处理、接口限流、支持一键生成前后端代码，支持动态国际化翻译(Vue3)，等诸多黑科技，代码简洁易懂、易扩展让开发更简单、更通用。
mukunku/ParquetViewer
Simple Windows desktop application for viewing & querying Apache Parquet files
colinin/abp-next-admin
这是基于vue-vben-admin 模板适用于abp vNext的前端管理项目
xunkong/xunkong
记录旅途中发生的事
VladislavAntonyuk/MauiSamples
.NET MAUI Samples
sdcb/chats
A powerful and flexible frontend & AI gateway for large language models, supporting 21+ mainstream AI model providers.
AIDotNet/Thor
Thor is a powerful artificial intelligence model management tool, whose main purpose is to achieve unified management and use of multiple AI models. Through Thor, users can easily manage and utilize numerous AI models
zmrid/iMES-Factory
iMES工厂管家——您的新一代工厂助手。演示地址：https://imes.625sc.com。 一款基于.NetCore3.1和Vue3的MES管理系统。项目亮点：模版打印，Excel模版导出，自定义实体扩展，移动端精美设计，大屏设计等功能。
lindexi/lindexi_gd
博客用到的代码
842549829/Panda
Abp.vNext + EF Core The microservices Open source framework project supports the implementation of message push workflow certification centers based on OAuth2.0
spacechase0/StardewValleyMods
New home for my stardew valley mod source code
ErrorLSC/Polars.NET
.NET DataFrame Engine, powered by Arrow and Polars
densen2014/BlazorMaui
用 c # 和 Razor 创建本机移动应用和桌面应用。使用 Blazor.BB.Maui，可以快速开发共享代码库运行于 Windows (Winforms/WPF/UWP)、Android、iOS、macOS 的应用。
shuyu-labs/Text2Sql.Net
Text2Sql.Net 是一个使用DotNet和Semantic Kernel开发的Text2Sql工具
densen2014/Blazor100
Blazor入门100天

https://github.com/mini-software/MiniExcel/tree/master/docs