如何使用 C# 自动调整 Excel 行高和列宽

在生成或处理 Excel 文件时，经常会遇到单元格内容显示不完整的问题。例如，文本太长导致列宽不够、换行内容显示不全，或者批量写入数据后表格布局不够整齐。

如果只是手动处理一个文件，可以在 Excel 中双击行列边界进行自动调整。但在后台程序、批量报表生成、数据导出等场景中，更常见的做法是通过代码自动调整行高和列宽。

本文将介绍如何使用 C# 自动调整 Excel 中的行高和列宽，主要包括以下几种场景：

• 自动调整整个工作表的行高和列宽
• 自动调整指定列的列宽
• 自动调整指定行的行高
• 自动调整指定单元格区域的行高和列宽

准备工作

本文示例使用 Free Spire.XLS for .NET 操作 Excel 文件。可以通过 NuGet 安装：

Install-Package FreeSpire.XLS

代码中需要引入以下命名空间：

using Spire.Xls;

示例中使用的 Excel 文件路径为：

E:FilesTest.xlsx

实际使用时，可以根据自己的文件路径进行修改。

一、自动调整整个工作表的行高和列宽

如果需要让工作表中的数据尽量完整显示，可以获取工作表的已使用区域，然后调用 ​​AutoFitColumns()​​ 和 ​​AutoFitRows()​​ 方法。

using Spire.Xls;

namespace AutofitColumn
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象
            Workbook workbook = new Workbook();

            // 加载 Excel 文件
            workbook.LoadFromFile(@"E:FilesTest.xlsx");

            // 获取第一个工作表
            Worksheet worksheet = workbook.Worksheets[0];

            // 自动调整已使用区域的列宽
            worksheet.AllocatedRange.AutoFitColumns();

            // 自动调整已使用区域的行高
            worksheet.AllocatedRange.AutoFitRows();

            // 保存结果文件
            workbook.Sa veToFile(@"E:FilesAutoFit.xlsx", FileFormat.Version2010);

            workbook.Dispose();
        }
    }
}

这里的 ​​AllocatedRange​​ 表示当前工作表中实际使用到的单元格区域。相比直接处理整个工作表，它更适合用于普通数据表，也可以避免对大量空白区域进行不必要的处理。

二、自动调整指定列的列宽

有些表格并不需要调整所有列，只需要处理某些内容较长的字段，例如“产品名称”“客户名称”“地址”“备注”等。这种情况下，可以只对指定列执行自动调整。

下面的示例用于自动调整第一列的列宽：

using Spire.Xls;

namespace AutoFitSpecificColumn
{
    class Program
    {
        static void Main(string[] args)
        {
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(@"E:FilesTest.xlsx");

            Worksheet worksheet = workbook.Worksheets[0];

            // 自动调整第 1 列的列宽
            // 注意：这里的列索引从 1 开始
            worksheet.AutoFitColumn(1);

            workbook.Sa veToFile(@"E:FilesAutoFitColumn.xlsx", FileFormat.Version2010);

            workbook.Dispose();
        }
    }
}

如果需要调整多列，可以使用循环：

// 自动调整第 1 列到第 3 列
for (int i = 1; i 3; i++)
{
    worksheet.AutoFitColumn(i);
}

这种方式适合列数较多，但只有部分字段需要自适应宽度的表格。

三、自动调整指定行的行高

当单元格中包含换行文本、较大字号文本，或者导入内容较多时，行高可能无法完整显示内容。此时可以只调整指定行的高度。

下面的示例用于自动调整第一行的行高：

using Spire.Xls;

namespace AutoFitSpecificRow
{
    class Program
    {
        static void Main(string[] args)
        {
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(@"E:FilesTest.xlsx");

            Worksheet worksheet = workbook.Worksheets[0];

            // 自动调整第 1 行的行高
            // 注意：这里的行索引从 1 开始
            worksheet.AutoFitRow(1);

            workbook.Sa veToFile(@"E:FilesAutoFitRow.xlsx", FileFormat.Version2010);

            workbook.Dispose();
        }
    }
}

如果需要调整多行，也可以使用循环：

// 自动调整第 1 行到第 10 行
for (int i = 1; i 10; i++)
{
    worksheet.AutoFitRow(i);
}

这种方式比较适合处理标题行、说明行，或者某些内容长度不固定的数据行。

四、自动调整指定单元格区域

在实际业务中，很多 Excel 文件并不是整个工作表都需要处理。例如，一个工作表中可能同时包含标题、说明、数据表、签名区域等内容。此时可以只对某个指定区域自动调整行高和列宽。

下面的示例对 ​​A1:D10​​ 区域进行自动调整：

using Spire.Xls;

namespace AutoFitRange
{
    class Program
    {
        static void Main(string[] args)
        {
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(@"E:FilesTest.xlsx");

            Worksheet worksheet = workbook.Worksheets[0];

            // 获取指定单元格区域
            CellRange range = worksheet.Range["A1:D10"];

            // 自动调整该区域的列宽
            range.AutoFitColumns();

            // 自动调整该区域的行高
            range.AutoFitRows();

            workbook.Sa veToFile(@"E:FilesAutoFitRange.xlsx", FileFormat.Version2010);

            workbook.Dispose();
        }
    }
}

这种方式适合报表模板类文件。例如只调整数据明细区域，而不影响上方标题、页眉说明或底部备注区域的布局。

注意事项

自动调整行高和列宽主要根据单元格中的内容进行计算。实际使用时，可以注意以下几点：

1. 自动换行： 如果单元格中包含较长文本或多行文本，可以先开启自动换行，再调用 ​​AutoFitRows()​​ 自动调整行高。

// 开启已使用区域的自动换行
worksheet.AllocatedRange.IsWrapText = true;

// 根据内容自动调整行高
worksheet.AllocatedRange.AutoFitRows();

需要注意的是，​​IsWrapText = true​​ 会改变单元格的显示样式，使文本在单元格内自动换行。如果希望保持原有模板布局，不建议对整个工作表直接设置，可以只对指定区域设置：

CellRange range = worksheet.Range["A1:D10"];
range.IsWrapText = true;
range.AutoFitRows();

2. 合并单元格： 如果表格中存在合并单元格，自动调整行高或列宽的效果可能与普通单元格不同，尤其是跨多列合并的文本区域。对于这类区域，可以在自动调整后检查显示效果，必要时手动设置行高或列宽。

3. 空白单元格： 如果单元格内容为空，自动调整通常不会产生明显变化。实际处理时，建议优先对已使用区域或指定数据区域执行自动调整。

4. 性能开销： 对于数据量较大的工作簿，建议只调整实际需要处理的局部区域，避免对整个工作表进行不必要的计算。

总结

在C#操作Excel文件时，自动调整行高和列宽是常见需求。对于一般的数据表，可直接对工作表的已用区域调用​​AutoFitColumns()​​和​​AutoFitRows()​​；而对于结构复杂的文件，可仅处理指定行、列或单元格区域。

合理使用这些方法，可以让程序生成的 Excel 文件更加整洁，也能减少用户后续手动调整表格布局的工作。