使用 IRONXL

使用IronXL将 C# 中的 DataGridView 导出到 Excel

已更新:2026年2月27日

使用IronXL将 DataGridView 数据导出到 Excel（C#），消除对 Microsoft Office 的依赖，并提供容器友好的部署。创建 WorkBook，遍历 DataGridView 个单元格，并以具有完整格式支持的 XLSX 格式保存。

将 Windows Forms 中的数据导出到 Excel 是商业应用程序中的常见需求。无论是生成报告、创建数据备份，还是与利益相关者共享信息，开发人员都需要一种可靠的方法将 GridView 数据导出为 Excel 格式。使用 Microsoft Office Interop 的传统方法已经达到了这个目的，但它们存在部署复杂性和依赖性要求，这可能会使应用程序分发变得复杂。

本教程演示了一个实用的 C# 示例，使用IronXL （一个.NET库，无需安装 Microsoft Office）将 DataGridView 数据导出到 Excel。您将探索如何实现一个干净、高效的导出解决方案，该方案可在不同的环境中运行，包括云平台和容器。无论是部署到 Azure 还是在 Docker 容器中运行应用程序， IronXL都能提供 DevOps 团队所需的部署灵活性。

IronXL首页展示了无需 Microsoft Office 或 Excel Interop 即可读取 Excel 文件的 C# 代码示例，并提供了语法高亮和NuGet下载统计信息。

为什么导出到 Excel 至关重要？

DataGridView 控件是 Windows 窗体应用程序的基础，用于显示用户每天与之交互的表格数据。将此数据导出到 Excel 后，用户可以应用 Excel 强大的分析工具、创建演示文稿，并与可能无法访问该应用程序的同事共享数据。 C# Excel导出功能对于业务报告和数据分析工作流程至关重要。

使用Microsoft.Office.Interop.Excel的传统导出方法需要在运行该应用程序的每台计算机上安装 Excel。这在服务器环境中或将应用程序分发给没有 Office 许可证的用户时会带来部署挑战。此外，Interop 方法可能会遇到内存泄漏和 COM 对象清理问题，如果没有小心处理。当部署到 AWS Lambda 或其他无法安装 Office 的无服务器平台时，这些挑战会变得尤为严峻。

现代 .NET 应用程序需要灵活解决方案。 IronXL通过提供一个独立的库来应对这些挑战，该库可以生成不依赖于任何 Microsoft Office 的 Excel 文件。这种方法确保了开发、测试和生产环境的功能一致性，同时支持部署到容器和云平台。

跨平台支持图，展示了.NET在多个版本（9、8、7、6、Core、Standard、Framework）上的兼容性，并包含Windows、Linux、Mac、Docker、Azure和AWS等各种平台的图标。

IronXL和 Interop 有什么区别？

下表总结了IronXL和 Microsoft Office Interop 在 Excel 导出场景中的主要区别：

IronXL与 Microsoft Office Interop 在 Excel 导出方面的比较
特征	IronXL	Microsoft Interop
需要安装办公软件	无	是
Linux/Docker 支持	是	无
COM对象清理	无需	手动操作，容易出错
内存泄漏风险	低的	如果不加以处置，后果不堪设想。
云/无服务器部署	支持	不支持
导出格式（XLSX、CSV、JSON、XML）	所有支持	数量有限

如何在 C# 项目中安装IronXL ？

在 Visual Studio 中打开程序包管理器控制台并运行以下命令，或者使用.NET CLI：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

SHELL

终端输出显示在 C# 项目中成功安装了IronXl.Excel NuGet包及其依赖项

有关详细的安装选项，请参阅IronXL NuGet安装指南或直接在NuGet上搜索该软件包。安装完成后，将 using IronXL; 添加到您的 C# 项目文件中，即可访问该库的 Excel 导出功能。部署到生产环境时，请应用您的许可证密钥以启用所有功能。您可以先获得免费试用许可证，以便在购买前评估IronXL 。

基本的 DataGridView 导出是什么样的？

以下代码创建了一个示例 Windows 窗体应用程序，其中包含填充的数据，然后使用IronXL顶级语句将其导出到 Excel：

using IronXL;
using System.Data;
using System.Windows.Forms;

// Create a DataTable with sample product data
var dt = new DataTable();
dt.Columns.Add("Product ID", typeof(int));
dt.Columns.Add("Product Name", typeof(string));
dt.Columns.Add("Category", typeof(string));
dt.Columns.Add("Price", typeof(decimal));
dt.Columns.Add("Stock", typeof(int));

dt.Rows.Add(1001, "Laptop Pro", "Electronics", 1299.99m, 15);
dt.Rows.Add(1002, "Wireless Mouse", "Accessories", 29.99m, 50);
dt.Rows.Add(1003, "USB-C Cable", "Accessories", 19.99m, 100);
dt.Rows.Add(1004, "Monitor 27\"", "Electronics", 399.99m, 8);
dt.Rows.Add(1005, "Keyboard Mechanical", "Accessories", 89.99m, 25);

// Bind to DataGridView
var dataGridView1 = new DataGridView();
dataGridView1.DataSource = dt;

// Create new Excel workbook
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Export column headers
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.SetCellValue(0, colIndex, dataGridView1.Columns[colIndex].HeaderText);
}

// Export data rows
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            if (cellValue is decimal or double or int)
                worksheet.SetCellValue(rowIndex + 1, colIndex, Convert.ToDouble(cellValue));
            else
                worksheet.SetCellValue(rowIndex + 1, colIndex, cellValue?.ToString() ?? string.Empty);
        }
    }
}

// Save the Excel file
workbook.SaveAs("DataGridViewExport.xlsx");
Console.WriteLine("Export completed successfully!");

using IronXL;
using System.Data;
using System.Windows.Forms;

// Create a DataTable with sample product data
var dt = new DataTable();
dt.Columns.Add("Product ID", typeof(int));
dt.Columns.Add("Product Name", typeof(string));
dt.Columns.Add("Category", typeof(string));
dt.Columns.Add("Price", typeof(decimal));
dt.Columns.Add("Stock", typeof(int));

dt.Rows.Add(1001, "Laptop Pro", "Electronics", 1299.99m, 15);
dt.Rows.Add(1002, "Wireless Mouse", "Accessories", 29.99m, 50);
dt.Rows.Add(1003, "USB-C Cable", "Accessories", 19.99m, 100);
dt.Rows.Add(1004, "Monitor 27\"", "Electronics", 399.99m, 8);
dt.Rows.Add(1005, "Keyboard Mechanical", "Accessories", 89.99m, 25);

// Bind to DataGridView
var dataGridView1 = new DataGridView();
dataGridView1.DataSource = dt;

// Create new Excel workbook
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Export column headers
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.SetCellValue(0, colIndex, dataGridView1.Columns[colIndex].HeaderText);
}

// Export data rows
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            if (cellValue is decimal or double or int)
                worksheet.SetCellValue(rowIndex + 1, colIndex, Convert.ToDouble(cellValue));
            else
                worksheet.SetCellValue(rowIndex + 1, colIndex, cellValue?.ToString() ?? string.Empty);
        }
    }
}

// Save the Excel file
workbook.SaveAs("DataGridViewExport.xlsx");
Console.WriteLine("Export completed successfully!");

$vbLabelText $csharpLabel

这段代码展示了核心的导出功能。 DataTable 设置使用示例产品数据填充网格，作为 DataGridView 控件的通用数据源。处理大型数据集时，可考虑使用 IronXL 的数据集导入和导出功能以提高性能。

导出循环遍历 DataGridView，使用 SetCellValue 和行和列索引将标题和数据放入 Excel 单元格中。 IronXL文档涵盖了针对更复杂场景的其他单元格写入选项。 IsNewRow 检查会跳过可编辑的 DataGridViews 底部的空行，从而确保 Excel 输出干净，不会出现意外的空白行。

Windows Forms 应用程序，显示一个 DataGridView，其中填充了产品数据，包括产品 ID、名称、类别、价格和库存列，下方有一个

Microsoft Excel 电子表格，显示导出的产品数据，包含产品 ID、产品名称、类别、价格和库存水平等列，涵盖电子产品和电脑配件。

如果您在基于 Web 的ASP.NET MVC 应用程序中实现此功能，请通过使用 Content-Disposition HTTP 标头将文件作为可下载的响应返回来扩展该方法。对于ASP.NET WebForms 开发人员，导出控件时可能需要重写 VerifyRenderingInServerForm 以确保正确呈现。请访问IronXL功能页面，查看支持场景的完整列表。

如何为Excel导出文件添加专业格式？

专业的 Excel 导出通常需要格式化以提高可读性。 IronXL提供样式设置功能，包括字体自定义、背景颜色、边框和对齐方式。以下示例添加了标题格式和交替行颜色：

using IronXL;
using System.Data;
using System.Windows.Forms;

// Assume dataGridView1 is already populated with data
var dataGridView1 = new DataGridView();

// (populate dataGridView1 with data as shown in the previous example)

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Set column headers with formatting
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    var headerCell = worksheet.GetCellAt(0, colIndex);
    headerCell.Value = dataGridView1.Columns[colIndex].HeaderText;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.Color = "#FFFFFF";
    headerCell.Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center;
}

// Export data with alternating row colors
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            var excelCell = worksheet.GetCellAt(rowIndex + 1, colIndex);

            if (cellValue != null)
                excelCell.Value = cellValue.ToString();

            // Apply alternating row background
            if (rowIndex % 2 == 0)
                excelCell.Style.BackgroundColor = "#F2F2F2";
        }
    }
}

// Auto-fit columns
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.AutoSizeColumn(colIndex);
}

workbook.SaveAs("FormattedExport.xlsx");
Console.WriteLine("Formatted export completed successfully!");

using IronXL;
using System.Data;
using System.Windows.Forms;

// Assume dataGridView1 is already populated with data
var dataGridView1 = new DataGridView();

// (populate dataGridView1 with data as shown in the previous example)

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Set column headers with formatting
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    var headerCell = worksheet.GetCellAt(0, colIndex);
    headerCell.Value = dataGridView1.Columns[colIndex].HeaderText;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.Color = "#FFFFFF";
    headerCell.Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center;
}

// Export data with alternating row colors
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            var excelCell = worksheet.GetCellAt(rowIndex + 1, colIndex);

            if (cellValue != null)
                excelCell.Value = cellValue.ToString();

            // Apply alternating row background
            if (rowIndex % 2 == 0)
                excelCell.Style.BackgroundColor = "#F2F2F2";
        }
    }
}

// Auto-fit columns
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.AutoSizeColumn(colIndex);
}

workbook.SaveAs("FormattedExport.xlsx");
Console.WriteLine("Formatted export completed successfully!");

$vbLabelText $csharpLabel

此增强版可为导出的 Excel 文件应用专业格式。标题采用粗体文本，蓝色背景，白色字体，与数据行形成清晰的视觉区分。该代码使用取模运算实现交替行颜色，提高了大型数据集的可读性。您可以使用IronXL单元格格式指南进一步自定义外观，或者应用合并单元格功能来跨越标题列。

AutoSizeColumn 方法会调整列宽以适应内容，从而避免导出后手动调整。这些格式化选项将基本的数据导出转变为可以立即分享给用户的演示文档。查看如何使用IronXL编写 Excel 文件，了解更多格式设置和数据写入模式。

如何导出为多种格式并添加公式？

IronXL 的功能不仅限于基本的 Excel 导出，还提供公式支持、多工作表和替代输出格式等功能。以下示例演示了这些功能：

using IronXL;

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// (populate worksheet with DataGridView data as shown above)
int dataRowCount = 5; // Replace with actual dataGridView1.Rows.Count

// Add a SUM formula to calculate the total price column
worksheet.SetCellValue(dataRowCount + 2, 3, $"=SUM(D2:D{dataRowCount + 1})");

// Create a summary worksheet
var summarySheet = workbook.CreateWorkSheet("Summary");
summarySheet.SetCellValue(0, 0, "Total Products");
summarySheet.SetCellValue(0, 1, dataRowCount);

// Save in multiple formats
workbook.SaveAs("export.xlsx");
workbook.SaveAsCsv("export.csv");
workbook.SaveAsJson("export.json");
workbook.SaveAsXml("export.xml");

Console.WriteLine("Multi-format export completed!");

using IronXL;

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// (populate worksheet with DataGridView data as shown above)
int dataRowCount = 5; // Replace with actual dataGridView1.Rows.Count

// Add a SUM formula to calculate the total price column
worksheet.SetCellValue(dataRowCount + 2, 3, $"=SUM(D2:D{dataRowCount + 1})");

// Create a summary worksheet
var summarySheet = workbook.CreateWorkSheet("Summary");
summarySheet.SetCellValue(0, 0, "Total Products");
summarySheet.SetCellValue(0, 1, dataRowCount);

// Save in multiple formats
workbook.SaveAs("export.xlsx");
workbook.SaveAsCsv("export.csv");
workbook.SaveAsJson("export.json");
workbook.SaveAsXml("export.xml");

Console.WriteLine("Multi-format export completed!");

$vbLabelText $csharpLabel

IronXL支持 Excel 公式，允许您直接向导出的文件添加计算。上面的示例添加了一个公式，用于自动计算列总计。创建多个工作表有助于组织复杂的导出，例如将详细数据与摘要信息分开。请访问IronXL 的操作指南，了解如何创建 Excel 文件以获得更多工作表管理模式。

格式的灵活性对于集成场景尤其有价值。虽然 XLSX 是 Excel 文件的标准格式，但CSV 导出提供了与数据库系统和旧版应用程序的通用兼容性。 JSON 和 XML 格式便于与 Web 服务和 API 进行数据交换。您还可以打开现有工作簿，将导出的数据追加到现有电子表格中，而无需每次都创建新文件。

不同导出格式有何区别？

Excel电子表格显示了产品库存，包含产品ID、名称、类别、价格和库存列，单元格D9中显示了求和公式的结果1839.95。

Excel 电子表格显示了一个名为

Excel电子表格显示产品库存数据，包含产品ID、产品名称、类别、价格和库存数量列，单元格D9中显示总和为1839.95。

JSON 文件，在代码编辑器界面中显示产品数据，包含产品 ID、名称、类别、价格和库存字段。

XML 文件显示了导出的 DataGridView 数据，其中包含产品信息，包括 ID、名称、类别、价格和库存水平，并按 Sheet 元素进行组织。

IronXL如何简化您的 C# 开发工作流程？

IronXL 的主要优势在于无需依赖 Microsoft Office。无论部署在开发人员工作站、客户机器还是 Docker 容器中，您的应用程序都能稳定运行。这种独立性简化了部署并减少了与 Office 版本和安装相关的支持问题。微软的Open XML SDK是另一个无需 Office 的替代方案，但与 IronXL 的高级 API 相比，它需要编写更多的样板代码。有关跨平台.NET 10 开发指南， Microsoft .NET文档涵盖了平台目标、部署模型和 Windows Forms 的具体内容。

该库的 API 设计优先考虑简单性。与 Interop 基于 COM 的方法需要谨慎地处理对象不同， IronXL使用标准的.NET模式，这对于 C# 开发人员来说感觉很自然。跨平台支持意味着为 Windows Forms 构建的导出功能可以在运行于 Linux 服务器上的ASP.NET Core应用程序中重用。如需全面了解可用功能，请访问IronXL功能页面。

您还可以从 Excel 导入数据，以便在导出之前预先填充 DataGridView，从而创建往返工作流程，用户可以加载 Excel 数据，在网格中编辑数据，然后将结果导出回 Excel。读取Excel文件指南详细介绍了导入部分。

处理敏感数据时， IronXL支持工作簿级和工作表级密码保护。 IronXL文档涵盖了在分发之前必须保护导出文件的安全选项。

Excel库功能概览，包含六大主要类别：创建、保存和导出、编辑工作簿、处理数据、保护工作簿以及编辑布局选项。

生产用途有哪些授权选项？

IronXL在生产环境中部署需要有效的许可证密钥。您可以先申请免费试用许可证，解锁所有功能进行评估。查看IronXL许可页面，了解从单开发者许可到无限企业部署的各种许可级别的完整详细信息。

在使用IronXL 的任何功能之前，请先在您的应用程序中应用许可证密钥：

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

$vbLabelText $csharpLabel

这一行代码会在应用程序进程的整个生命周期内激活该库。对于 Web 应用程序和服务，请在启动时设置许可证密钥，以便所有请求都能享受到完整的功能集，而不会出现水印。

IronXL licensing options showing four tiers: Lite ($749), Plus ($999), Professional ($1,999), and Unlimited ($3,999) with varying developer, location, and project limits