在生成或处理 Excel 文件时经常会遇到单元格内容显示不完整的问题。例如文本太长导致列宽不够、换行内容显示不全或者批量写入数据后表格布局不够整齐。如果只是手动处理一个文件可以在 Excel 中双击行列边界进行自动调整。但在后台程序、批量报表生成、数据导出等场景中更常见的做法是通过代码自动调整行高和列宽。本文将介绍如何使用 C# 自动调整 Excel 中的行高和列宽主要包括以下几种场景自动调整整个工作表的行高和列宽自动调整指定列的列宽自动调整指定行的行高自动调整指定单元格区域的行高和列宽准备工作本文示例使用 Free Spire.XLS for .NET 操作 Excel 文件。可以通过 NuGet 安装Install-Package FreeSpire.XLS代码中需要引入以下命名空间using Spire.Xls;示例中使用的 Excel 文件路径为E:\Files\Test.xlsx实际使用时可以根据自己的文件路径进行修改。一、自动调整整个工作表的行高和列宽如果需要让工作表中的数据尽量完整显示可以获取工作表的已使用区域然后调用AutoFitColumns()和AutoFitRows()方法。using Spire.Xls; namespace AutofitColumn { class Program { static void Main(string[] args) { // 创建 Workbook 对象 Workbook workbook new Workbook(); // 加载 Excel 文件 workbook.LoadFromFile(E:\Files\Test.xlsx); // 获取第一个工作表 Worksheet worksheet workbook.Worksheets[0]; // 自动调整已使用区域的列宽 worksheet.AllocatedRange.AutoFitColumns(); // 自动调整已使用区域的行高 worksheet.AllocatedRange.AutoFitRows(); // 保存结果文件 workbook.SaveToFile(E:\Files\AutoFit.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:\Files\Test.xlsx); Worksheet worksheet workbook.Worksheets[0]; // 自动调整第 1 列的列宽 // 注意这里的列索引从 1 开始 worksheet.AutoFitColumn(1); workbook.SaveToFile(E:\Files\AutoFitColumn.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:\Files\Test.xlsx); Worksheet worksheet workbook.Worksheets[0]; // 自动调整第 1 行的行高 // 注意这里的行索引从 1 开始 worksheet.AutoFitRow(1); workbook.SaveToFile(E:\Files\AutoFitRow.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:\Files\Test.xlsx); Worksheet worksheet workbook.Worksheets[0]; // 获取指定单元格区域 CellRange range worksheet.Range[A1:D10]; // 自动调整该区域的列宽 range.AutoFitColumns(); // 自动调整该区域的行高 range.AutoFitRows(); workbook.SaveToFile(E:\Files\AutoFitRange.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 文件更加整洁也能减少用户后续手动调整表格布局的工作。
