MiniExcel

简介

MiniExcel 是一个为 .NET 设计的简单高效的 Excel 处理工具，专注于最小化内存使用。

目前，大多数主流框架需要将 Excel 文档中的所有数据加载到内存中以便进行操作，但这可能导致内存消耗过高的问题。MiniExcel 的方法不同：它以流式方式逐行处理数据，将原本可能高达数百兆字节的消耗降低到仅几兆字节，有效防止内存溢出（OOM）问题。

flowchart LR
    A1(["Excel analysis
process"]) --> A2{{"Unzipping
XLSX file"}} --> A3{{"Parsing
OpenXML"}} --> A4{{"Model
conversion"}} --> A5(["Output"])
    B1(["Other Excel
Frameworks"]) --> B2{{"Memory"}} --> B3{{"Memory"}} --> B4{{"Workbooks &
Worksheets"}} --> B5(["All rows at
the same time"])
    C1(["MiniExcel"]) --> C2{{"Stream"}} --> C3{{"Stream"}} --> C4{{"POCO or dynamic"}} --> C5(["Deferred execution
row by row"])
    classDef analysis fill:#D0E8FF,stroke:#1E88E5,color:#0D47A1,font-weight:bold;
    classDef others fill:#FCE4EC,stroke:#EC407A,color:#880E4F,font-weight:bold;
    classDef miniexcel fill:#E8F5E9,stroke:#388E3C,color:#1B5E20,font-weight:bold;
    class A1,A2,A3,A4,A5 analysis;
    class B1,B2,B3,B4,B5 others;
    class C1,C2,C3,C4,C5 miniexcel;

功能特点

• 最小化内存消耗，防止内存溢出（OOM）错误并避免完整垃圾回收
• 支持实时、行级数据操作，在大数据集上实现更优性能
• 支持 LINQ 延迟执行，实现高效、节省内存的分页与复杂查询
• 轻量级，无需安装 Microsoft Office 或 COM+ 组件，DLL 文件小于 500KB
• 简单直观的 API 风格，便于读取/写入/填充 Excel

2.0 预览版

我们正在开发未来版本的 MiniExcel，采用全新模块化和聚焦的 API， Core 和 Csv 功能将分离为独立的 Nuget 包，完全支持通过 IAsyncEnumerable 进行异步流式查询， 并有更多新功能即将推出！这些包将以预发布版本提供，欢迎您试用并反馈意见！

如果您尝试了新版本，请务必查看 新文档 和 升级说明。

入门指南

• 导入/查询 Excel
• 导出/创建 Excel
• Excel 模板
• Excel 列名/索引/忽略属性
• 示例

安装方法

您可以通过 NuGet 安装此包

更新日志

请查看 更新日志

待办事项

请查看 TODO

性能

基准测试的代码可以在 MiniExcel.Benchmarks 中找到。

用于性能测试的文件是 Test1,000,000x10.xlsx，这是一个 32MB 的文档，包含 1,000,000 行 * 10 列，每个单元格都填充了字符串 "HelloWorld"。

要运行所有基准测试，请使用：

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

Excel 查询/导入

#### 1. 执行查询并将结果映射到强类型的 IEnumerable [[试一试]](https://dotnetfiddle.net/w5WD1J)

建议使用 Stream.Query，因为其效率更高。

public class UserAccount
{
    public Guid ID { get; set; }
    public string Name { get; set; }
    public DateTime BoD { get; set; }
    public int Age { get; set; }
    public bool VIP { get; set; }
    public decimal Points { get; set; }
}
var rows = MiniExcel.Query(path);
// or
using (var stream = File.OpenRead(path))
    var rows = stream.Query();

#### 2. 执行查询并将其映射到动态对象列表，不使用表头 [[试一试]](https://dotnetfiddle.net/w5WD1J)

• dynamic 键为 A.B.C.D..

var rows = MiniExcel.Query(path).ToList();
// or
using (var stream = File.OpenRead(path))
{
    var rows = stream.Query().ToList();
    Assert.Equal("MiniExcel", rows[0].A);
    Assert.Equal(1, rows[0].B);
    Assert.Equal("Github", rows[1].A);
    Assert.Equal(2, rows[1].B);
}

注意：相同的列名使用最右边的一个

输入的 Excel ：

| 列1 | 列2 | |------------|---------| | MiniExcel | 1 | | Github | 2 |

var rows = MiniExcel.Query(useHeaderRow:true).ToList();
// or
using (var stream = File.OpenRead(path))
{
    var rows = stream.Query(useHeaderRow:true).ToList();
    Assert.Equal("MiniExcel", rows[0].Column1);
    Assert.Equal(1, rows[0].Column2);
    Assert.Equal("Github", rows[1].Column1);
    Assert.Equal(2, rows[1].Column2);
}

查询 First

var row = MiniExcel.Query(path).First();
Assert.Equal("HelloWorld", row.A);
// or
using (var stream = File.OpenRead(path))
{
    var row = stream.Query().First();
    Assert.Equal("HelloWorld", row.A);
}

#### 5. 按工作表名称查询

MiniExcel.Query(path, sheetName: "SheetName");
//or
stream.Query(sheetName: "SheetName");

var sheetNames = MiniExcel.GetSheetNames(path);
foreach (var sheetName in sheetNames)
{
    var rows = MiniExcel.Query(path, sheetName: sheetName);
}

var columns = MiniExcel.GetColumns(path); // e.g result : ["A","B"...]
var cnt = columns.Count;  // get column count

foreach(IDictionary row in MiniExcel.Query(path))
{
    //..
}
// or
var rows = MiniExcel.Query(path).Cast>();
// or Query specified ranges (capitalized)
// A2 represents the second row of column A, C3 represents the third row of column C
// If you don't want to restrict rows, just don't include numbers
var rows = MiniExcel.QueryRange(path, startCell: "A2", endCell: "C3").Cast>();

不推荐，因为 DataTable 会将所有数据加载到内存中，并且会失去 MiniExcel 的低内存消耗特性。

``C# var table = MiniExcel.QueryAsDataTable(path, useHeaderRow: true);

#### 10. 指定开始读取数据的单元格

#### 11. 填充合并单元格
注意：与“不使用合并填充”相比，效率较慢
原因：OpenXml 标准将 mergeCells 放在文件底部，这导致需要对 sheetxml 遍历两次

支持可变长度和宽度的多行多列填充
#### 12. 通过基于磁盘的缓存读取大文件（基于磁盘的缓存 - SharedString）
如果 SharedStrings 大小超过 5 MB，MiniExcel 默认会使用本地磁盘缓存，例如，10x100000.xlsx（一百万行数据），禁用磁盘缓存时最大内存占用为 195MB，但启用磁盘缓存只需 65MB。注意，这种优化会有一定的效率损失，因此读取时间会从 7.4 秒增加到 27.2 秒。如果不需要此功能，可以通过以下代码禁用磁盘缓存：

您可以使用 SharedStringCacheSize 来更改 sharedString 文件的大小，使其超出指定的磁盘缓存大小

创建/导出 Excel  
必须是具有公共无参数构造函数的非抽象类型。
MiniExcel 支持参数 IEnumerable 的延迟执行，如果你想使用最少的内存，请不要调用如 ToList 之类的方法。
例如：ToList 或不使用内存的方式
#### 1. 匿名类型或强类型 [[在线尝试]](https://dotnetfiddle.net/w5WD1J)

#### 2. IEnumerable>

创建文件结果：
| 列1       | 列2     |
|-----------|---------|
| MiniExcel | 1       |
| Github    | 2       |

#### 3.  IDataReader
推荐使用，它可以避免将所有数据加载到内存中

DataReader 导出多个工作表（推荐使用 Dapper ExecuteReader）

#### 4. 数据表
不推荐，它会将所有数据加载到内存中
DataTable 首先使用 Caption 作为列名，其次使用列名（columname）

####  5. Dapper 查询
感谢 @shaofing #552 ，请使用 CommandDefinition + CommandFlags.NoCache

以下代码将把所有数据加载到内存中

#### 6. SaveAs 到 MemoryStream  [[试一试]](https://dotnetfiddle.net/JOen0e)

例如：导出 Excel 的 API

#### 7. 创建多个工作表

#### 8. TableStyles 选项
默认样式
无样式配置

#### 9. 自动筛选
自 v0.19.0 起，OpenXmlConfiguration.AutoFilter 可以启用/禁用自动筛选，默认值为 true，设置自动筛选的方法如下：

#### 10. 创建镜像

#### 11. 字节数组文件导出
自 1.22.0 版本起，当值类型为 byte[] 时，系统默认会在单元格中保存文件路径，导入时系统会自动转换为 byte[]。如果不想使用该功能，可以将 OpenXmlConfiguration.EnableConvertByteArray 设置为 false，这样可以提升系统效率。
自 1.22.0 版本起，当值类型为 byte[] 时，系统默认会在单元格中保存文件路径，导入时系统会自动转换为 byte[]。如果不想使用该功能，可以将 OpenXmlConfiguration.EnableConvertByteArray 设置为 false，这样可以提升系统效率。
#### 12. 垂直合并相同单元格
此功能仅在 xlsx 格式中支持，并且在 @merge 和 @endmerge 标签之间进行垂直合并单元格。
你可以使用 @mergelimit 来限制垂直合并单元格的范围。

合并前后的文件内容：
无合并限制：
有限合并：
#### 13. 跳过空值
新增显式选项，用于在空值时写入空单元格：

先前的行为：

适用于 null 和 DBNull 值。
#### 14. 冻结窗格

向 Excel 模板填充数据 
声明方式类似于 Vue 模板中的 {{变量名}}，或者集合渲染 {{集合名.字段名}}

集合渲染支持 IEnumerable/DataTable/DapperRow
#### 1. 基础填充
模板：
结果：
代码：

#### 2. IEnumerable 数据填充
注1：使用相同列的第一个 IEnumerable 作为填充列表的基础
模板：
结果：
代码：

#### 3. 复杂数据填充
注意：支持多表单并使用相同变量
模板：
结果：

#### 4. 填充大数据性能
注意：在 MiniExcel 中使用 IEnumerable 的延迟执行而不是 ToList 可以最大限度地节省内存使用
#### 5. 单元格值自动映射类型
模板
结果
类

代码

#### 6. 示例 :  列出 Github 项目
模板

结果
代码

#### 7. 分组数据填充

##### 1. 同时使用 @group 标签和 @header 标签
之前
之后
##### 2. 使用 @group 标签但不使用 @header 标签
之前
之后
##### 3. 不使用 @group 标签
之前
之后
#### 8. 单元格内的 If/ElseIf/Else 语句
规则：
支持 DateTime、Double、Int 类型的 ==、!=、>、>=、<、<= 运算符。
支持 String 类型的 ==、!= 运算符。
每条语句应为新的一行。
运算符前后应有一个空格。
语句内部不应换行。
单元格内容应与下面格式完全一致。

在此之前
之后
#### 9. DataTable 作为参数

#### 10. 公式
##### 1. 示例
在你的公式前加上 $ 前缀，并使用 $enumrowstart 和 $enumrowend 来标记可枚举的起始和结束行的引用：
当模板被渲染时，$ 前缀会被移除，$enumrowstart 和 $enumrowend 会被替换为可枚举的起始和结束行号：
##### 2. 其他示例公式：
|              |                                                                                           |
|--------------|-------------------------------------------------------------------------------------------|
| 求和         | $=SUM(C{{$enumrowstart}}:C{{$enumrowend}})                                              |
| 替代平均值   | $=SUM(C{{$enumrowstart}}:C{{$enumrowend}}) / COUNT(C{{$enumrowstart}}:C{{$enumrowend}}) |
| 区间         | $=MAX(C{{$enumrowstart}}:C{{$enumrowend}}) - MIN(C{{$enumrowstart}}:C{{$enumrowend}})   |

#### 11. 其他
##### 1. 检查模板参数键
自V1.24.0版本起，默认忽略模板缺失参数键并用空字符串替换，IgnoreTemplateParameterMissing 可以控制是否抛出异常。

Excel 列名/列索引/忽略属性 
#### 1. 指定列名、列索引、忽略列
Excel 示例
代码

#### 2. 自定义格式（ExcelFormatAttribute）
自 V0.21.0 起，支持包含 ToString(string content) 方法格式的类
类

代码

结果
查询支持自定义格式转换
#### 3. 设置列宽（ExcelColumnWidthAttribute）

#### 4. 多个列名映射到同一个属性。

#### 5. System.ComponentModel.DisplayNameAttribute = ExcelColumnName.excelColumnNameAttribute
自 1.24.0 版本起，系统支持 System.ComponentModel.DisplayNameAttribute = ExcelColumnName.excelColumnNameAttribute

#### 6. ExcelColumnAttribute
自 V1.26.0 起，多个属性可以简化为如下形式：

#### 7. DynamicColumnAttribute
自 V1.26.0 起，我们可以动态设置 Column 的属性

#### 8. 动态Sheet属性
自 V1.31.4 起，我们可以动态设置 Sheet 的属性。我们可以设置 sheet 的名称和状态（可见性）。

我们也可以使用新的属性 ExcelSheetAttribute：

### 添加、删除、更新
#### 添加
v1.28.0 支持在最后一行之后插入 N 行 CSV 数据

v1.37.0 支持在现有工作簿中插入新的 Excel 工作表

#### 删除（等待）
#### 更新（等待）
Excel 类型自动检测 
MiniExcel 默认会根据 文件扩展名 检查是 xlsx 还是 csv，但可能不准确，请手动指定。

流（Stream）无法判断来源于哪种 excel，请手动指定。

CSV
#### 注意
默认返回 string 类型，值不会被转换为数字或日期时间，除非通过强类型泛型定义了类型。
#### 自定义分隔符
默认使用 , 作为分隔符，你可以通过修改 Seperator 属性进行自定义

自 V1.30.1 起支持自定义分隔符功能（感谢 @hyzx86）

#### 自定义换行符
默认情况下，换行符为\r\n，你可以通过修改NewLine属性来自定义

#### 自定义编码
默认编码为“从字节顺序标记检测编码”（detectEncodingFromByteOrderMarks: true）
如果您有自定义编码需求，请修改 StreamReaderFunc / StreamWriterFunc 属性

#### 将空字符串读取为 null
默认情况下，空值会映射为 string.Empty。你可以修改此行为

### DataReader
#### 1. GetReader
自 1.23.0 起，您可以使用 GetDataReader

###  异步
v0.17.0 支持异步（感谢 isdaniel ( SHIH,BING-SIOU)](https://github.com/isdaniel))

-  v1.25.0 支持 cancellationToken。
其他
#### 1. 枚举
请确保 Excel 列名与属性名一致，系统将自动映射（不区分大小写）
自 V0.18.0 起支持枚举描述

自1.30.0版本起支持通过Excel中的Description转换为枚举，感谢@KaneLeung
#### 2. 将CSV转换为XLSX或将XLSX转换为CSV

`csharp
using (var excelStream = new FileStream(path: filePath, FileMode.Open, FileAccess.Read))
using (var csvStream = new MemoryStream())
{
   MiniExcel.ConvertXlsxToCsv(excelStream, csvStream);
}

自 1.22.0 起，您可以像下面这样自定义 CultureInfo，系统默认使用 CultureInfo.InvariantCulture。

var config = new CsvConfiguration()
{
    Culture = new CultureInfo("fr-FR"),
};
MiniExcel.SaveAs(path, value, configuration: config);
// or
MiniExcel.Query(path, configuration: config);

#### 4. 自定义缓冲区大小

    public abstract class Configuration : IConfiguration
    {
        public int BufferSize { get; set; } = 1024 * 512;
    }

#### 5. 快速模式

系统不会控制内存，但你可以获得更快的保存速度。

var config = new OpenXmlConfiguration() { FastMode = true };
MiniExcel.SaveAs(path, reader,configuration:config);

#### 6. 批量添加图片（MiniExcel.AddPicture）

请在批量生成行数据之前添加图片，否则在调用 AddPicture 时系统会占用大量内存。

var images = new[]
{
    new MiniExcelPicture
    {
        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/github_logo.png")),
        SheetName = null, // default null is first sheet
        CellAddress = "C3", // required
    },
    new MiniExcelPicture
    {
        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/google_logo.png")),
        PictureType = "image/png", // default PictureType = image/png
        SheetName = "Demo",
        CellAddress = "C9", // required
        WidthPx = 100,
        HeightPx = 100,
    },
};
MiniExcel.AddPicture(path, images);

#### 7. 获取工作表尺寸

var dim = MiniExcel.GetSheetDimensions(path);

示例：

#### 1. SQLite & Dapper 大文件 SQL 插入避免 OOM

注意：请勿在 Query 之后调用 ToList/ToArray 方法，这会将所有数据加载到内存中

using (var connection = new SQLiteConnection(connectionString))
{
    connection.Open();
    using (var transaction = connection.BeginTransaction())
    using (var stream = File.OpenRead(path))
    {
       var rows = stream.Query();
       foreach (var row in rows)
             connection.Execute("insert into T (A,B) values (@A,@B)", new { row.A, row.B }, transaction: transaction);
       transaction.Commit();
    }
}

性能表现：

#### 2. ASP.NET Core 3.1 或 MVC 5 下载/上传 Excel Xlsx API 演示 试用

public class ApiController : Controller
{
    public IActionResult Index()
    {
        return new ContentResult
        {
            ContentType = "text/html",
            StatusCode = (int)HttpStatusCode.OK,
            Content = @"
DownloadExcel

DownloadExcelFromTemplatePath

DownloadExcelFromTemplateBytes

Upload Excel

     

    

    public IActionResult DownloadExcel()
    {
        var values = new[] {
            new { Column1 = "MiniExcel", Column2 = 1 },
            new { Column1 = "Github", Column2 = 2}
        };
        var memoryStream = new MemoryStream();
        memoryStream.SaveAs(values);
        memoryStream.Seek(0, SeekOrigin.Begin);
        return new FileStreamResult(memoryStream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
        {
            FileDownloadName = "demo.xlsx"
        };
    }
    public IActionResult DownloadExcelFromTemplatePath()
    {
        string templatePath = "TestTemplateComplex.xlsx";
        Dictionary value = new Dictionary()
        {
            ["title"] = "FooCompany",
            ["managers"] = new[] {
                new {name="Jack",department="HR"},
                new {name="Loan",department="IT"}
            },
            ["employees"] = new[] {
                new {name="Wade",department="HR"},
                new {name="Felix",department="HR"},
                new {name="Eric",department="IT"},
                new {name="Keaton",department="IT"}
            }
        };
        MemoryStream memoryStream = new MemoryStream();
        memoryStream.SaveAsByTemplate(templatePath, value);
        memoryStream.Seek(0, SeekOrigin.Begin);
        return new FileStreamResult(memoryStream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
        {
            FileDownloadName = "demo.xlsx"
        };
    }
    private static Dictionary TemplateBytesCache = new Dictionary();
    static ApiController()
    {
        string templatePath = "TestTemplateComplex.xlsx";
        byte[] bytes = System.IO.File.ReadAllBytes(templatePath);
        TemplateBytesCache.Add(templatePath, bytes);
    }
    public IActionResult DownloadExcelFromTemplateBytes()
    {
        byte[] bytes = TemplateBytesCache["TestTemplateComplex.xlsx"];
        Dictionary value = new Dictionary()
        {
            ["title"] = "FooCompany",
            ["managers"] = new[] {
                new {name="Jack",department="HR"},
                new {name="Loan",department="IT"}
            },
            ["employees"] = new[] {
                new {name="Wade",department="HR"},
                new {name="Felix",department="HR"},
                new {name="Eric",department="IT"},
                new {name="Keaton",department="IT"}
            }
        };
        MemoryStream memoryStream = new MemoryStream();
        memoryStream.SaveAsByTemplate(bytes, value);
        memoryStream.Seek(0, SeekOrigin.Begin);
        return new FileStreamResult(memoryStream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
        {
            FileDownloadName = "demo.xlsx"
        };
    }
    public IActionResult UploadExcel(IFormFile excel)
    {
        var stream = new MemoryStream();
        excel.CopyTo(stream);
        foreach (var item in stream.Query(true))
        {
            // do your logic etc.
        }
        return Ok("File uploaded successfully");
    }
}

#### 3. 分页查询

void Main()
{
    var rows = MiniExcel.Query(path);
    Console.WriteLine("==== No.1 Page ====");
    Console.WriteLine(Page(rows,pageSize:3,page:1));
    Console.WriteLine("==== No.50 Page ====");
    Console.WriteLine(Page(rows,pageSize:3,page:50));
    Console.WriteLine("==== No.5000 Page ====");
    Console.WriteLine(Page(rows,pageSize:3,page:5000));
}
public static IEnumerable Page(IEnumerable en, int pageSize, int page)
{
    return en.Skip(page * pageSize).Take(pageSize);
}

#### 4. WebForm 通过 MemoryStream 导出 Excel

var fileName = "Demo.xlsx";
var sheetName = "Sheet1";
HttpResponse response = HttpContext.Current.Response;
response.Clear();
response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
response.AddHeader("Content-Disposition", $"attachment;filename=\"{fileName}\"");
var values = new[] {
    new { Column1 = "MiniExcel", Column2 = 1 },
    new { Column1 = "Github", Column2 = 2}
};
var memoryStream = new MemoryStream();
memoryStream.SaveAs(values, sheetName: sheetName);
memoryStream.Seek(0, SeekOrigin.Begin);
memoryStream.CopyTo(Response.OutputStream);
response.End();

#### 5. 动态 i18n 多语言与角色权限管理

如示例所示，创建一个方法来处理 i18n 和权限管理，并使用 yield return 返回 IEnumerable>，以实现动态和低内存处理效果

void Main()
{
    var value = new Order[] {
        new Order(){OrderNo = "SO01",CustomerID="C001",ProductID="P001",Qty=100,Amt=500},
        new Order(){OrderNo = "SO02",CustomerID="C002",ProductID="P002",Qty=300,Amt=400},
    };
    Console.WriteLine("en-Us and Sales role");
    {
        var path = Path.GetTempPath() + Guid.NewGuid() + ".xlsx";
        var lang = "en-US";
        var role = "Sales";
        MiniExcel.SaveAs(path, GetOrders(lang, role, value));
        MiniExcel.Query(path, true).Dump();
    }
    Console.WriteLine("zh-CN and PMC role");
    {
        var path = Path.GetTempPath() + Guid.NewGuid() + ".xlsx";
        var lang = "zh-CN";
        var role = "PMC";
        MiniExcel.SaveAs(path, GetOrders(lang, role, value));
        MiniExcel.Query(path, true).Dump();
    }
}
private IEnumerable> GetOrders(string lang, string role, Order[] orders)
{
    foreach (var order in orders)
    {
        var newOrder = new Dictionary();
        if (lang == "zh-CN")
        {
            newOrder.Add("客户编号", order.CustomerID);
            newOrder.Add("订单编号", order.OrderNo);
            newOrder.Add("产品编号", order.ProductID);
            newOrder.Add("数量", order.Qty);
            if (role == "Sales")
                newOrder.Add("价格", order.Amt);
            yield return newOrder;
        }
        else if (lang == "en-US")
        {
            newOrder.Add("Customer ID", order.CustomerID);
            newOrder.Add("Order No", order.OrderNo);
            newOrder.Add("Product ID", order.ProductID);
            newOrder.Add("Quantity", order.Qty);
            if (role == "Sales")
                newOrder.Add("Amount", order.Amt);
            yield return newOrder;
        }
        else
        {
            throw new InvalidDataException($"lang {lang} wrong");
        }
    }
}
public class Order
{
    public string OrderNo { get; set; }
    public string CustomerID { get; set; }
    public decimal Qty { get; set; }
    public string ProductID { get; set; }
    public decimal Amt { get; set; }
}

常见问题解答

#### 问：Excel表头标题与类属性名不一致，如何映射？

答：请使用 ExcelColumnName 特性

#### 问：如何查询或导出多工作表？

答：使用 GetSheetNames 方法，并结合 Query 的 sheetName 参数。

var sheets = MiniExcel.GetSheetNames(path);
foreach (var sheet in sheets)
{
    Console.WriteLine($"sheet name : {sheet} ");
    var rows = MiniExcel.Query(path,useHeaderRow:true,sheetName:sheet);
    Console.WriteLine(rows);
}

#### 问：如何查询或导出有关工作表可见性的信息？

答：使用 GetSheetInformations 方法。

var sheets = MiniExcel.GetSheetInformations(path);
foreach (var sheetInfo in sheets)
{
    Console.WriteLine($"sheet index : {sheetInfo.Index} "); // next sheet index - numbered from 0
    Console.WriteLine($"sheet name : {sheetInfo.Name} ");   // sheet name
    Console.WriteLine($"sheet state : {sheetInfo.State} "); // sheet visibility state - visible / hidden
}

#### 问：使用 Count 会将所有数据加载到内存中吗？

不会，图片测试中有 100 万行*10 列数据，最大内存占用小于 60MB，耗时 13.65 秒

#### 问：Query 如何使用整数索引？

Query 默认索引是字符串键：A、B、C……如果想更改为数字索引，请创建如下方法进行转换

void Main()
{
    var path = @"D:\git\MiniExcel\samples\xlsx\TestTypeMapping.xlsx";
    var rows = MiniExcel.Query(path,true);
    foreach (var r in ConvertToIntIndexRows(rows))
    {
        Console.Write($"column 0 : {r[0]} ,column 1 : {r[1]}");
        Console.WriteLine();
    }
}
private IEnumerable> ConvertToIntIndexRows(IEnumerable