SpreadCheetah 开源项目教程

SpreadCheetah 开源项目教程

spreadcheetahSpreadCheetah is a high-performance .NET library for generating spreadsheet (Microsoft Excel XLSX) files.项目地址:https://gitcode.com/gh_mirrors/sp/spreadcheetah

1. 项目介绍

SpreadCheetah 是一个高性能的 .NET 库，专门用于生成 Microsoft Excel XLSX 格式的电子表格文件。该项目旨在通过流式处理的方式创建电子表格文件，从而保持较低的内存占用。SpreadCheetah 支持多种基本电子表格功能，如不同数据类型的单元格、基本样式和公式。未来版本将增加更多高级功能。

2. 项目快速启动

安装

首先，通过 NuGet 安装 SpreadCheetah：

dotnet add package SpreadCheetah

创建第一个 Excel 文件

以下是一个简单的示例，展示如何使用 SpreadCheetah 创建一个包含数据的 Excel 文件：

using SpreadCheetah;
using System.IO;

public class Program
{
    public static void Main()
    {
        using var stream = new MemoryStream();
        using var spreadsheet = new Spreadsheet(stream);

        var worksheet = spreadsheet.AddWorksheet("Sheet1");

        worksheet.AddRow(new[] { "Name", "Age", "City" });
        worksheet.AddRow(new[] { "Alice", "30", "New York" });
        worksheet.AddRow(new[] { "Bob", "25", "Los Angeles" });

        spreadsheet.Finish();

        File.WriteAllBytes("example.xlsx", stream.ToArray());
    }
}

运行代码

将上述代码保存为 Program.cs，然后在终端中运行：

dotnet run

运行后，将在当前目录下生成一个名为 example.xlsx 的 Excel 文件。

3. 应用案例和最佳实践

应用案例

SpreadCheetah 适用于需要生成大量 Excel 文件的场景，例如：

• 数据导出：将数据库中的数据导出为 Excel 文件。
• 报告生成：生成包含统计数据的报告文件。
• 批量处理：批量生成包含不同数据的 Excel 文件。

最佳实践

• 流式处理：尽量使用流式处理方式生成文件，以减少内存占用。
• 单元格样式：合理使用单元格样式，避免过度复杂的样式设置。
• 公式支持：利用 SpreadCheetah 的公式支持，生成包含计算结果的 Excel 文件。

4. 典型生态项目

SpreadCheetah 可以与其他 .NET 生态项目结合使用，例如：

• EPPlus：另一个流行的 .NET Excel 库，支持更复杂的 Excel 操作。
• ClosedXML：提供简单易用的 API 来操作 Excel 文件。
• NPOI：支持生成和读取 Excel、Word 和 PowerPoint 文件。

通过结合这些项目，可以实现更复杂的 Excel 文件处理需求。

spreadcheetahSpreadCheetah is a high-performance .NET library for generating spreadsheet (Microsoft Excel XLSX) files.项目地址:https://gitcode.com/gh_mirrors/sp/spreadcheetah