如何在 C# 中合并 Excel 单元格

Source: Dev.to

前置条件

在开始之前，请确保您具备以下条件：

• 已在机器上安装 Visual Studio。
• 已安装 Spire.XLS。您可以从官方网站下载，或在 Visual Studio 中通过 NuGet 安装。

通过 NuGet 安装 Spire.XLS：

1. 在 Visual Studio 中打开 NuGet 包管理器。
2. 搜索 Spire.XLS 并点击 Install。

完成后即可开始。

项目设置

1. 在 Visual Studio 中创建一个新的 控制台应用程序 项目。

   • 打开 Visual Studio。
   • 选择 创建新项目。
   • 选择 控制台应用 (.NET Core)。
   • 为项目命名（例如 MergeCellsInExcel）。
   • 点击 创建。

2. 通过 NuGet 包管理器将 Spire.XLS 库添加到项目中。

使用 C# 合并 Excel 单元格的代码示例

下面是一个简单的合并单元格示例：

using System;
using Spire.Xls;

namespace MergeCellsExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new Workbook
            Workbook workbook = new Workbook();

            // Access the first worksheet
            Worksheet sheet = workbook.Worksheets[0];

            // Set some data in the cells
            sheet.Range["A1"].Text = "Merged Cells Example";
            sheet.Range["A2"].Text = "This is a sample cell content.";

            // Merge cells from A1 to D1
            sheet.Range["A1:D1"].Merge();

            // Format the merged cell
            sheet.Range["A1"].CellStyle.HorizontalAlignment = HorizontalAlignType.Center;
            sheet.Range["A1"].CellStyle.VerticalAlignment = VerticalAlignType.Center;
            sheet.Range["A1"].CellStyle.Font.IsBold = true;
            sheet.Range["A1"].CellStyle.Font.Size = 14;

            // Save the workbook to a file
            workbook.SaveToFile("MergedCellsExample.xlsx", ExcelVersion.Version2013);

            Console.WriteLine("Excel file with merged cells created successfully!");
        }
    }
}

代码说明

创建工作簿

Workbook workbook = new Workbook();

初始化一个新的 Excel 工作簿。

访问工作表

Worksheet sheet = workbook.Worksheets[0];

获取工作簿中的第一个工作表。

在单元格中写入数据

sheet.Range["A1"].Text = "Merged Cells Example";

向单元格 A1 写入文本。

合并单元格

sheet.Range["A1:D1"].Merge();

将范围 A1:D1 合并为一个单元格。

格式化合并后的单元格

sheet.Range["A1"].CellStyle.HorizontalAlignment = HorizontalAlignType.Center;
sheet.Range["A1"].CellStyle.VerticalAlignment = VerticalAlignType.Center;
sheet.Range["A1"].CellStyle.Font.IsBold = true;
sheet.Range["A1"].CellStyle.Font.Size = 14;

使文本居中、加粗并将字体大小设为 14。

保存工作簿

workbook.SaveToFile("MergedCellsExample.xlsx", ExcelVersion.Version2013);

将文件保存为 MergedCellsExample.xlsx，兼容 Excel 2013 及以上版本。

运行代码

构建并运行您的应用程序。程序将生成一个包含合并单元格的 Excel 文件。用 Excel 打开该文件，验证单元格已正确合并并格式化。

其他技巧

合并多行或多列

通过更改单元格范围可以合并行或列。例如，垂直合并单元格：

sheet.Range["A1:A5"].Merge();

取消合并单元格

取消先前合并的范围：

sheet.Range["A1:D1"].UnMerge();

格式化

Spire.XLS 提供丰富的格式化选项，包括颜色、边框和其他样式，帮助您创建视觉效果出色的 Excel 文档。

结论

在 Excel 中合并单元格是组织数据和创建结构化报表的强大工具。使用 C# 中的 Spire.XLS 可以在应用程序中自动化此过程。上述示例提供了一个基本的入门框架，您可以在此基础上加入动态数据输入、条件格式或跨多个工作表的自动化操作。