面向 .NET 的 C# XLSX、ODS 和 CSV 无需 Office

适用于 XLSX 文件的 C# Excel 库

sgcDocs 是一个 C# Excel 库,可创建和读取带公式、样式和数字格式的 XLSX 文件,无需安装 Office,支持 Windows、Linux 和 macOS。

可计算 320 个 Excel 函数 字体、填充、边框、数字格式 ASP.NET Core、服务、Linux 同一 API 中的 DOCX 和 PDF

包含在 sgcUI .NET Enterprise 中。查看价格 →

using esegece.sgcDocs;

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.New();
    sheet.SetValues("A1", "Units");
    sheet.SetValues("A2", 12);
    sheet.SetValues("A3", 30);
    sheet.SetFormulas("A4", "=SUM(A2:A3)");
    sheet.Calculate();
    sheet.SaveToFile("units.xlsx");
    sheet.ExportToPDFFile("units.pdf");
}

如何在 C# 中创建 Excel 文件

若要在没有 Excel 的情况下用 C# 创建 Excel 文件,请创建 TsgcDocsSpreadsheet,调用 New,按单元格地址写入值和公式,设置单元格格式,然后调用 SaveToFile。格式由文件扩展名决定,因此同一个工作簿也可以保存为 ODS 或 CSV。

using System;
using esegece.sgcDocs;
using esegece.sgcGrid;

static class SalesReport
{
    public static void Create()
    {
        using (var sheet = new TsgcDocsSpreadsheet())
        {
            sheet.New();
            sheet.RenameSheet(0, "Sales");

            // a header row and three data rows, from one and two dimensional arrays
            sheet.SetRange("A1", new object[] { "Product", "Units", "Price", "Total" });
            sheet.SetRange("A2", new object[,]
            {
                { "Paper", 12, 4.5 },
                { "Toner", 3, 39.9 },
                { "Labels", 20, 2.75 }
            });

            // formulas, calculated by the engine and saved with the file
            sheet.SetFormulas("D2", "=B2*C2");
            sheet.SetFormulas("D3", "=B3*C3");
            sheet.SetFormulas("D4", "=B4*C4");
            sheet.SetValues("A5", "Total");
            sheet.SetFormulas("D5", "=SUM(D2:D4)");

            // a bold, centred header with a fill colour (ARGB)
            TsgcGridCellFormat header = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            header.Bold = true;
            header.Alignment = TsgcGridAlignment.gaCenter;
            header.FillColor = 0xFFDDEBF7;
            sheet.SetFormat("A1:D1", header);

            // a number format for the money columns
            TsgcGridCellFormat money = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            money.NumberFormat = "#,##0.00";
            sheet.SetFormat("C2:D5", money);

            // column widths in DIPs
            sheet.SetColumnWidths("A", 140);
            sheet.SetColumnWidths("D", 90);

            sheet.Calculate();
            Console.WriteLine("Total: " + sheet.Text("D5"));
            sheet.SaveToFile("sales.xlsx");
        }
    }
}

文件会保留公式及其计算后的值。Text 会返回单元格的打印效果,即应用了数字格式的结果。C# 类保留了 Delphi 版本的名称:带索引的属性(例如 Values['A1'])变成方法对 Values 和 SetValues,Formulas、ColumnWidths 和 RowHeights 也是如此。

在 C# 中读取和更新 XLSX 文件

LoadFromFile 和 LoadFromStream 可加载 XLSX、ODS 和 CSV,包括值、公式、样式、合并单元格、布局、页面设置、保护、图表以及 XLSX 文件的条件格式。修改你需要的内容,重新计算并保存。

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.LoadFromFile("sales.xlsx");
    Console.WriteLine(sheet.SheetNames(0) + ": " + sheet.UsedRange());
    Console.WriteLine("D2 formula: " + sheet.Formulas("D2"));
    Console.WriteLine("Units of B3: " + sheet.Values("B3"));

    // change a value, calculate again, save and print to PDF
    sheet.SetValues("B3", 5);
    sheet.Calculate();
    Console.WriteLine("New total: " + sheet.Text("D5"));
    sheet.SaveToFile("sales_updated.xlsx");
    Console.WriteLine(sheet.ExportToPDFFile("sales.pdf") + " PDF page(s)");
}

Values 返回 object:空单元格为 null,日期为 DateTime,错误则为错误文本,例如 #DIV/0!。Evaluate 会针对工作簿运行任意公式,而无需将其写入单元格。

XLSX 文件中的公式、样式和数据

TsgcDocsSpreadsheet 背后的工作簿引擎是托管的 C# 代码。运行它的机器上无需 Excel、COM 互操作或原生库。

320 个 Excel 函数

以 = 开头的文本是公式。引擎可计算 320 个 Excel 函数,包括 LET、LAMBDA 和具名 LAMBDA 函数,DefineName 可添加 VAT 等工作簿名称或可重用的 LAMBDA。

样式和数字格式

SetFormat 可设置区域的字号、粗体、斜体、颜色、填充、对齐、换行、数字格式、边框、缩进和旋转。MergeCells 可合并区域。

布局和工作表

列宽和行高,AddSheet、RenameSheet(会重写引用该工作表的公式)、DeleteSheet,以及工作表和工作簿保护。

来自数据库的数据

ImportDataSet 会将 DataTable 或 IDataReader 复制到工作表中,以列标题或字段名作为表头行,并返回行数。

保留图表

加载并重新保存 XLSX 文件时,会保留格式、合并单元格、图表和条件格式,工作表的图表也会随工作表一起打印。

PDF、HTML 和 PNG 输出

ExportToPDFFile 按工作簿的页面设置打印一个工作表或每个可见工作表,ExportToHTML 为每个工作表写出一个 HTML 表格,ExportSheetPageToPNG 则渲染一个打印页面。

ASP.NET Core 和 Linux 上的 Excel 文件

该包可在 Windows、Linux 和 macOS 上的控制台程序、服务、ASP.NET Core 和桌面应用程序中运行。SaveToStream 会将工作簿写入任意流,因此 Web API 无需临时文件即可返回 XLSX 文件。

using esegece.sgcDocs;

var app = WebApplication.CreateBuilder(args).Build();

// GET /report.xlsx returns a workbook built for the request
app.MapGet("/report.xlsx", () =>
{
    var stream = new MemoryStream();
    using (var sheet = new TsgcDocsSpreadsheet())
    {
        sheet.New();
        sheet.SetValues("A1", "Generated");
        sheet.SetValues("B1", DateTime.Now);
        sheet.SaveToStream(stream, TsgcDocsFormat.dfXLSX);
    }
    stream.Position = 0;
    return Results.File(stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "report.xlsx");
});

app.Run();

这些组件不是线程安全的:请在处理请求的线程中创建该请求所需的组件,不同的实例可以并行运行。在 Linux 和容器中,请安装文档所用的 TrueType 字体,或使用 AddFontFolder 添加字体文件夹。.NET 演示包含 ConversionServer,这是一个在服务器上转换文档的 ASP.NET Core 最小 API。

同时也是 C# DOCX 库:Word 和 PDF 文件

同一个包也可创建和读取 Word 文档。TsgcDocsWordProcessor 可读写 DOCX、RTF、HTML、Markdown 和文本,可通过 DataTable、CSV 或 JSON 执行邮件合并,并导出为 PDF。TsgcDocsConverter 可一次调用在文档、电子表格、PDF 文件和图像之间转换。

// a Word document saved as DOCX and PDF
using (var word = new TsgcDocsWordProcessor())
{
    word.New();
    word.Title = "Quarterly report";
    word.AppendParagraph("Quarterly report", "Heading 1");
    word.AppendParagraph("Sales grew 12% in the third quarter.");
    word.SaveToFile("report.docx");
    word.ExportToPDFFile("report.pdf");
    Console.WriteLine("Pages: " + word.PageCount);
}

// one call conversions, the formats come from the file extensions
using (var converter = new TsgcDocsConverter())
{
    converter.Convert("sales.xlsx", "sales.csv");
    converter.Convert("report.docx", "report.html");
}

Word 文档

使用 ReplaceAll 填充在 Word 中制作的 DOCX 模板,或将其与你的数据合并,并将结果保存为 DOCX 或 PDF。

PDF 处理

TsgcDocsPDFProcessor 可合并、拆分和旋转页面,提取文本,填写表单,使用 AES-256 加密,转换为 PDF/A 并签名。

条形码和 ZIP

TsgcDocsBarcode 可将 QR Code、Data Matrix、Code 128 等写成 PNG、SVG,或绘制在 PDF 页面上,TsgcDocsZipArchive 可构建 ZIP64 压缩包。

从 NuGet 安装 C# Excel 库

将包 esegece.sgcDocs 添加到项目中。NuGet 会添加它所依赖的引擎:esegece.sgcUICore、esegece.sgcPDF、esegece.sgcRichEdit、esegece.sgcGrid、esegece.sgcSpreadsheet 和 esegece.sgcCharts。

dotnet add package esegece.sgcDocs

esegece.sgcDocs 是 Registered 包,包含在 sgcUI .NET Enterprise 和 All-Access 中,不会发布到 nuget.org。文档和工作表的 PNG 和 SVG 页面还需要另一个包 esegece.sgcUICore.Rendering,这样只写出 XLSX、DOCX 和 PDF 文件的服务器就不必携带原生渲染库。

包目标框架运行环境
esegece.sgcDocs.NET Standard 2.0、.NET Framework 4.7.2、.NET 6、8、9 和 10Windows、Linux 和 macOS,适用于控制台程序、服务、ASP.NET Core 和桌面应用程序
esegece.sgcUICore.Rendering仅在需要时添加文档和工作表的 PNG 和 SVG 页面

C# Excel 库包含在哪里

sgcDocs 不单独销售,也没有免费的 Community 版本。sgcUI .NET Enterprise 包含完整的 C# 源代码和 1 年更新。

sgcUI .NET Enterprise

包含适用于 .NET 的所有 sgcUI 产品(含 sgcDocs),并附带适用于 WinForms、WPF 和 Avalonia 的完整 C# 源代码,每位开发者 €699 起。

All-Access

包含所有 eSeGeCe 产品,含 sgcUI Enterprise 和 sgcDocs。

查看 All-Access →

也适用于 Delphi 和 C++ Builder

同样的 API 和类名,适用于 Delphi 7 到 13 和 C++ Builder 2007 到 13,支持 Win32、Win64 和 Linux64。

适用于 Delphi 的 sgcDocs →

常见问题解答

添加 esegece.sgcDocs 包,创建 TsgcDocsSpreadsheet,调用 New,用 SetValues 和 SetFormulas 写入单元格,然后调用 SaveToFile("report.xlsx")。工作簿由托管的 C# 代码写出,因此机器上无需安装 Excel 或 Office。

可以。以 = 开头的文本是公式,引擎会在保存文件之前计算 320 个 Excel 函数,因此 XLSX 同时包含公式及其值。SetFormat 可设置区域的字体、颜色、填充、对齐、换行、边框和数字格式,SetColumnWidths 和 SetRowHeights 用于调整布局大小。

可以,支持 XLSX、ODS 和 CSV 文件。LoadFromFile 或 LoadFromStream 会加载值、公式、样式、合并单元格、页面设置、保护和图表,Values、Formulas 和 Text 可读取任意单元格。不支持二进制 XLS 格式。

能。该包面向 .NET Standard 2.0、.NET Framework 4.7.2 和 .NET 6 到 10,可在 Windows、Linux 和 macOS 上的控制台程序、服务、ASP.NET Core 和桌面应用程序中运行。由于组件不是线程安全的,请为每个请求创建一个组件,并在服务器上安装文档所用的 TrueType 字体。

可以。同一个包中的 TsgcDocsWordProcessor 可创建、读取和编辑 DOCX、RTF、HTML 和 Markdown 文档,填充模板,执行邮件合并并导出为 PDF。TsgcDocsPDFProcessor 可合并、加密、转换为 PDF/A 并为 PDF 文件签名。

没有。sgcDocs 没有免费的 Community 版本。.NET 包仅限 Registered,包含在 sgcUI .NET Enterprise 和 All-Access 中,不会发布到 nuget.org。如需 .NET 评估版,请联系我们。

包含。sgcUI .NET Enterprise 许可证包含完整的 C# 源代码和 1 年更新。请参阅 sgcUI 价格页面。

超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格

用 C# 代码创建 Excel 文件

一个 .NET 包即可处理 XLSX、DOCX 和 PDF,机器上无需安装 Office。