通过 C# 代码实现 Excel 页面精细化设置

在日常开发工作中，Excel 报表的批量处理和自动化生成是一项常见需求。然而，当数据准备就绪后，如何确保输出的 Excel 文件在打印或转换格式时具有统一的页面布局和专业的排版效果，往往是容易被忽视却又十分重要的环节。

本文将系统介绍如何使用 Free Spire.XLS for .NET 这一免费库，在 C# 中编程控制 Excel 工作表的页面设置参数，涵盖页边距、纸张方向、缩放比例、打印区域等核心配置项。

安装方式：
在Visual Studio中，通过 NuGet包管理器搜索 Free Spire.XLS 并安装，无需额外配置环境变量，直接引用即可使用。

页面设置的核心对象：PageSetup

在 Free Spire.XLS 中，几乎所有页面设置相关的功能都通过 PageSetup 类来实现。PageSetup 对象封装了 Excel 工作表的打印与显示配置，涵盖页边距、纸张大小、方向、缩放比、页眉页脚、打印区域等多个方面。

Excel 页面设置核心流程如下：

1. 创建 Workbook 对象，代表 Excel 工作簿。
2. 使用 LoadFromFile() 方法加载目标 Excel 文件。
3. 通过 Workbook.Worksheets[index] 获取指定工作表。
4. 访问工作表的 PageSetup 属性即可获得页面设置对象。
5. 获取后，即可通过其丰富的属性进行各项配置，所有代码层面的修改最终通过 SaveToFile() 保存生效。

常用 Excel 页面设置（详细API+代码）

页边距设置

页边距控制着打印内容与纸张边缘之间的空白区域。PageSetup 类提供了六个与页边距相关的属性：

示例代码：

using Spire.Xls;

namespace PageMarginExample
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 创建Workbook对象并加载Excel文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("示例.xlsx");

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

            // 获取PageSetup对象
            PageSetup pageSetup = sheet.PageSetup;

            // 设置页边距（单位：英寸，1英寸 ≈ 2.54厘米）
            pageSetup.TopMargin = 1.0;        // 上边距1英寸
            pageSetup.BottomMargin = 1.0;     // 下边距1英寸
            pageSetup.LeftMargin = 0.75;      // 左边距0.75英寸
            pageSetup.RightMargin = 0.75;     // 右边距0.75英寸
            pageSetup.HeaderMarginInch = 0.5; // 页眉边距0.5英寸
            pageSetup.FooterMarginInch = 0.5; // 页脚边距0.5英寸

            // 保存修改后的文件
            workbook.SaveToFile("设置页边距.xlsx", ExcelVersion.Version2016);
            workbook.Dispose();
        }
    }
}

需要注意的是，该库习惯使用英寸作为边距单位。如果需要使用厘米，可通过单位换算（1英寸 = 2.54厘米）获取对应的英寸值。

纸张方向设置

纸张方向决定了内容的排版布局方式。纵向（Portrait）适合行数多、列数少的数据，横向（Landscape）则更适合宽表或多列数据。

示例代码：

// 获取PageSetup对象后（代码同上）
PageSetup pageSetup = sheet.PageSetup;

// 设置为纵向
pageSetup.Orientation = PageOrientationType.Portrait;

// 或设置为横向
// pageSetup.Orientation = PageOrientationType.Landscape;

当处理包含多个工作表且需要为不同工作表设置不同打印方向的场景时，务必注意一个关键配置：需要将 Workbook.ConverterSetting.PrintWithSheetPageSetting 属性设为 true，否则打印时多个工作表可能会统一使用同一个方向。

纸张大小设置

PaperSize属性用于指定打印纸张的规格。

示例代码：

// 设置为A4纸张
pageSetup.PaperSize = PaperSizeType.PaperA4;

常见纸张类型包括A4、A3、A5、Letter、Legal等，开发者可根据实际需求选择合适的纸张枚举值。

页面缩放与适应页面

页面缩放控制着工作表内容在打印时的尺寸比例。Free Spire.XLS提供了两种缩放控制方式：

方式一：固定缩放比例（Zoom）

通过Zoom属性直接设置缩放百分比（10 - 400之间的整数）：

// 设置为75%比例打印
pageSetup.Zoom = 75;

方式二：自动适应页宽/页高（FitToPages）

FitToPagesWide和FitToPagesTall属性用于将工作表内容缩放到指定的页面数量范围内：

// 所有列缩放到1页宽度，行数不限（自动分页）
pageSetup.FitToPagesWide = 1;
pageSetup.FitToPagesTall = 0;

// 或：将整个内容缩放到1页宽 × 1页高（所有内容挤在一页）
// pageSetup.FitToPagesWide = 1;
// pageSetup.FitToPagesTall = 1;

FitToPagesWide = 0时表示按实际宽度缩放，不自动调节；FitToPagesTall = 0时表示按实际高度缩放，不限制行数。

注意： Zoom属性与FitToPagesWide/FitToPagesTall属性互斥。当设置FitToPagesWide等属性时，Zoom参数将自动失效；反之亦然。

打印区域与打印标题

指定打印区域

当工作表数据量较大或只需要输出部分内容时，可以通过PrintArea属性指定仅打印特定范围的单元格：

// 仅打印A1到F50区域的单元格
pageSetup.PrintArea = "A1:F50";

PrintArea属性使用Excel标准的范围表示法（如"A1:C20"）。

设置打印标题行和列

在多页打印场景下，让标题行或标题列在每一页重复出现，可以大大提升报表的可读性。PrintTitleRows和PrintTitleColumns属性用于实现这一需求：

// 设置第1行和第2行为重复行标题（在每一页顶部重复显示）
pageSetup.PrintTitleRows = "$1:$2";

// 设置第A列重复（在每一页左侧重复显示）
// pageSetup.PrintTitleColumns = "$A:$A";

// 指定打印区域的同时保留打印标题的设置
pageSetup.PrintArea = "A1:F100";
pageSetup.PrintTitleRows = "$1:$2";

分页符控制

分页符用于手动控制Excel打印时的分页点。Free Spire.XLS支持在指定单元格位置插入横向分页符和纵向分页符。

插入横向分页符

横向分页符在指定单元格的左上方位置分页：

// 在第20行位置插入横向分页符（在第20行上方分页）
sheet.HPageBreaks.Add(sheet.Range["A20"]);

// 再在第35行位置插入一个横向分页符
sheet.HPageBreaks.Add(sheet.Range["A35"]);

插入纵向分页符

纵向分页符在指定单元格的左侧位置分页：

// 在第E列左侧插入纵向分页符
sheet.VPageBreaks.Add(sheet.Range["E1"]);

插入分页符后，Excel 在打印时会按照设定的分页点进行分页，精确控制内容的页面分布。

结语

本文提供了 C# 中实现各种 Excel 页面设置的能力。从基础的页边距、纸张方向，到进阶的打印区域和分页符控制，开发者可以完全通过编程方式自动化完成 Excel 文件的打印与显示配置。相较于手动逐一调整Excel文件，这种方法在大规模报表生成、文档标准化等场景下能够显著提升工作效率，同时确保输出文档的一致性和专业性。

所有 API 均为原生封装，与Excel逻辑完全对齐，希望本文能为需要处理 Excel 页面设置的 .NET 开发者提供实用的参考。