如何在C#中将DataGridView导出到包含列头的Excel

IronXL为何是理想之选？

IronXL 通过提供无需安装 Microsoft Excel 的直观 API，简化了 .NET 应用程序中的 Excel 操作。 与基于互操作性的解决方案不同，IronXL 可以独立运行，因此非常适合服务器环境和没有 Office 的机器。

该库可处理所有Excel 格式，包括 XLSX、XLS 和 CSV，并在整个导出过程中保持数据完整性和格式。 开发人员无需安装 Excel 即可轻松复制数据、扩展工作表以及删除或添加行。

设置 Windows 窗体项目

首先，在 Visual Studio 中创建一个新的 Windows 窗体应用程序。 项目准备就绪后，通过 NuGet 包管理器安装 IronXL。 打开软件包管理器控制台并运行：

Install-Package IronXL.Excel

安装完成后，请将以下必要的命名空间添加到您的表单中：

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

这些导入功能提供了对IronXL 的 Excel 功能、数据表操作和 Windows 窗体控件的访问，这些功能是导出过程所必需的。

使用示例数据创建 DataGridView

让我们构建一个简单的界面，其中包含一个填充了示例数据源的 DataGridView。 您可能还需要从 CSV 文件或数据库导入数据，下面的 DataTable 方法同样适用于导入的数据集。 通过 Visual Studio 设计器向窗体添加一个新的 DataGridView 和一个按钮，然后使用以下代码设置数据：

private void Form1_Load(object sender, EventArgs e)
{
    // Example object usage
    object obj = "Initializing DataTable"; 
    Console.WriteLine(obj);
    // Create a DataTable with sample data
    DataTable dt = new DataTable();
    // Add columns with descriptive headers
    dt.Columns.Add("Product ID", typeof(int));
    dt.Columns.Add("Product Name", typeof(string));
    dt.Columns.Add("Price", typeof(decimal));
    dt.Columns.Add("Stock Quantity", typeof(int));
    // Add sample rows
    dt.Rows.Add(1001, "Laptop", 999.99m, 15);
    dt.Rows.Add(1002, "Mouse", 29.99m, 50);
    dt.Rows.Add(1003, "Keyboard", 79.99m, 30);
    dt.Rows.Add(1004, "Monitor", 299.99m, 12);
    dt.Rows.Add(1005, "Headphones", 89.99m, 25);  
    // Bind the DataTable to DataGridView Control
    dataGridView1.DataSource = dt;
}

private void Form1_Load(object sender, EventArgs e)
{
    // Example object usage
    object obj = "Initializing DataTable"; 
    Console.WriteLine(obj);
    // Create a DataTable with sample data
    DataTable dt = new DataTable();
    // Add columns with descriptive headers
    dt.Columns.Add("Product ID", typeof(int));
    dt.Columns.Add("Product Name", typeof(string));
    dt.Columns.Add("Price", typeof(decimal));
    dt.Columns.Add("Stock Quantity", typeof(int));
    // Add sample rows
    dt.Rows.Add(1001, "Laptop", 999.99m, 15);
    dt.Rows.Add(1002, "Mouse", 29.99m, 50);
    dt.Rows.Add(1003, "Keyboard", 79.99m, 30);
    dt.Rows.Add(1004, "Monitor", 299.99m, 12);
    dt.Rows.Add(1005, "Headphones", 89.99m, 25);  
    // Bind the DataTable to DataGridView Control
    dataGridView1.DataSource = dt;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此示例创建一个数据表并将其绑定到网格。 即使数据量较小，该方法也能很好地扩展到更大的表格。 这里定义的列名将成为 Excel 文件中的标题。

示例数据代表了一个简单的产品库存，便于验证导出是否正确。 对于更复杂的数据绑定场景，微软关于DataGridView 数据绑定的文档提供了更多示例。

这将创建一个 DataGridView，其中填充了我们代码中的所有数据：

如何在 C# 中将带有列标题的 DataGridView 导出到 Excel：图 1 - DataGridView 中的示例数据

实现带列标题的导出

现在来说说主要功能，即在保留列标题的情况下将 DataGridView 导出到 Excel。 添加此方法来处理导出按钮的点击事件：

private void btnExport_Click(object sender, EventArgs e)
{
    // Create a new Excel workbook
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.CreateWorkSheet("Exported Data");
    // Export column headers
    for (int col = 0; col < dataGridView1.Columns.Count; col++)
    {
        worksheet.SetCellValue(0, col, dataGridView1.Columns[col].HeaderText);
    }
    // Export data rows
    for (int row = 0; row < dataGridView1.Rows.Count; row++)
    {
        // Skip the last empty row (used for adding new rows in DataGridView)
        if (dataGridView1.AllowUserToAddRows && row == dataGridView1.Rows.Count - 1)
            continue;
        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            var cellValue = dataGridView1.Rows[row].Cells[col].Value;
            if (cellValue != null)
            {
                worksheet.SetCellValue(row + 1, col, cellValue.ToString());
            }
        }
    }
    // Show save dialog
    using (SaveFileDialog saveFileDialog = new SaveFileDialog
    {
        Filter = "Excel Files|*.xlsx",
        FileName = "DataGridView_Export.xlsx"
    })
    {
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            workbook.SaveAs(saveFileDialog.FileName);
            MessageBox.Show("Export completed successfully!", "Success",
                            MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
}

private void btnExport_Click(object sender, EventArgs e)
{
    // Create a new Excel workbook
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.CreateWorkSheet("Exported Data");
    // Export column headers
    for (int col = 0; col < dataGridView1.Columns.Count; col++)
    {
        worksheet.SetCellValue(0, col, dataGridView1.Columns[col].HeaderText);
    }
    // Export data rows
    for (int row = 0; row < dataGridView1.Rows.Count; row++)
    {
        // Skip the last empty row (used for adding new rows in DataGridView)
        if (dataGridView1.AllowUserToAddRows && row == dataGridView1.Rows.Count - 1)
            continue;
        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            var cellValue = dataGridView1.Rows[row].Cells[col].Value;
            if (cellValue != null)
            {
                worksheet.SetCellValue(row + 1, col, cellValue.ToString());
            }
        }
    }
    // Show save dialog
    using (SaveFileDialog saveFileDialog = new SaveFileDialog
    {
        Filter = "Excel Files|*.xlsx",
        FileName = "DataGridView_Export.xlsx"
    })
    {
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            workbook.SaveAs(saveFileDialog.FileName);
            MessageBox.Show("Export completed successfully!", "Success",
                            MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此导出方法包含以下几个关键步骤：

1.创建工作簿：WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX) 在内存中初始化一个新的 Excel 文件。 2.添加工作表：CreateWorkSheet 方法会添加一个命名的工作表来保存您的数据。 3.导出表头：第一个循环遍历 DataGridView 列，提取 HeaderText 属性并将其写入第 0 行。 4.导出数据：嵌套循环处理每个表格单元格，并进行空值检查以防止错误。 5.用户友好的保存功能：SaveFileDialog 允许用户选择文件位置和名称

保留标题的关键在于访问 dataGridView1.Columns[i].HeaderText 属性，该属性包含每个列标题的显示文本。 您可以在每个导出步骤上方添加注释，以便向其他开发人员或未来的维护人员说明其目的。

如何在 C# 中将 DataGridView 导出到 Excel 并带有列标题：图 2 - 包含导出示例数据的输出 Excel 文件

处理常见的Excel文件数据导出场景

在处理真实世界数据时，您会遇到各种需要进行分析的场景。

特殊处理：

*空单元格*：我们的代码中的空值检查可以防止单元格不包含数据时出现错误。 在 Excel 中，空白单元格显示为空白，保持网格结构不变。 混合数据类型**：IronXL 自动处理不同的数据格式。 在 Excel 中，数字保持数值形式，可以进行计算，而文本则保持字符串形式。 *特殊字符：包含特殊字符的列标题可以正确导出。

IronXL 自动处理编码，保留像 &、<、> 和重音字母等字符。

导出文档时可能会出现错误。 使用 try-catch-finally 语句进行健壮处理：

try 
{
    // Export code here
}
catch (Exception ex)
{
    MessageBox.Show($"Export failed: {ex.Message}", "Error", 
                   MessageBoxButtons.OK, MessageBoxIcon.Error);
}

try 
{
    // Export code here
}
catch (Exception ex)
{
    MessageBox.Show($"Export failed: {ex.Message}", "Error", 
                   MessageBoxButtons.OK, MessageBoxIcon.Error);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronXL 会保留 Excel 表格的详细信息，例如格式、标题和特殊字符。 对于更高级的场景，您可以查阅 IronXL 文档作为参考，了解文件安全、单元格样式或公式保留等任务。

结论

使用 IronXL 将 DataGridView 导出到 Excel 并带有列标题非常简单。 该库负责处理复杂的 Excel 文件操作，让您可以专注于应用程序逻辑。 无论您选择逐单元格导出还是数据表导出，列标题都将完美地传输到 Excel 中。 这样可以轻松地将 DataGridView 数据转换为 Excel 格式，而不会丢失任何有用的标题或数据。

我们希望本文能帮助您为 DataGridView 导出需求实现可靠的解决方案，并且您可以自信地运用今天在这里学到的技能，将 DataGridView 导出为 Excel 格式。 如果您正在寻找可靠的 C# 将 DataGridView 导出到 Excel 并带有列标题的解决方案，IronXL 提供了一种简洁、无依赖项的方法来实现此目的。

准备好在您的项目中实施此功能了吗？首先使用 IronXL 的免费试用版，探索其全部功能。 生产用途的授权许可价格极具竞争力，并包含全面的技术支持。