C#使用Spire.PDF for .NET实现设置或修改PDF页面尺寸

 更新时间:2026年02月06日 08:31:24   作者:m5655bj  
在文档处理场景中,调整 PDF 页面尺寸是常见需求,本文将介绍如何使用免费库 Free Spire.PDF for .NET 通过 C# 代码设置或修改 PDF 页面尺寸,有需要的小伙伴可以了解下

在文档处理场景中,调整 PDF 页面尺寸是常见需求,例如将 A4 尺寸的 PDF 适配 A3 打印纸张、为移动端显示自定义窄版页面,或统一多来源 PDF 的页面规格。本文将介绍如何使用免费库 Free Spire.PDF for .NET 通过 C# 代码设置或修改 PDF 页面尺寸。

一、安装免费 .NET 库

通过 NuGet 包管理器安装(最便捷方式):

  • 打开Visual Studio → 右键项目 → 管理NuGet程序包 → 搜索“Free Spire.PDF” → 安装。
  • 或通过NuGet命令行安装:
Install-Package FreeSpire.PDF

注:Free Spire.PDF for .NET 有10页的页数限制,仅适用于小型文档。

二、C# 如何调整 PDF 页面尺寸

本文采用 “创建新 PDF 文档 + 原页面模板绘制” 的方式调整尺寸,核心优势是通过 PdfTextLayoutOnePage 布局自动适配内容到新页面,避免直接修改尺寸导致的内容裁剪或错位。

PDF 页面尺寸的核心单位为“点(Point)”,常见尺寸换算关系:

  • 1英寸 = 72点;
  • A4(210mm×297mm)= 595.28点 × 841.89点;
  • A3(297mm×420mm)= 841.89点 × 1190.55点。

Free Spire.PDF 类库提供 PdfUnitConvertor 工具类可便捷完成英寸、毫米与点的换算。

场景 1:将现有 PDF 修改为标准预设页面尺寸(A1)

适用于将 PDF 批量调整为行业标准尺寸(如 A1、A3、Letter 等),通过 Free Spire.PDF 预设的PdfPageSize 枚举直接指定尺寸,无需手动换算单位。

using Spire.Pdf;
using Spire.Pdf.Graphics;
using System.Drawing;

namespace ChangePageSizeToStandardPaperSize
{
    class Program
    {
        static void Main(string[] args)
        {            
            // 1. 创建PdfDocument实例并加载原始PDF
            PdfDocument originPdf = new PdfDocument();
            originPdf.LoadFromFile("Sample.pdf"); // 替换为你的PDF文件路径

            // 2. 创建新的PDF文档用于存储调整尺寸后的内容
            PdfDocument newPdf = new PdfDocument();

            // 3. 遍历原始PDF的所有页面,逐页调整尺寸
            foreach(PdfPageBase page in originPdf.Pages)
            { 
                // 3.1 新增A1尺寸的页面(设置边距为0)
                PdfPageBase newPage = newPdf.Pages.Add(PdfPageSize.A1, new PdfMargins(0));
                
                // 3.2 设置文本布局为“单页适配”,确保内容完整缩放至新页面
                PdfTextLayout layout = new PdfTextLayout();
                layout.Layout = PdfLayoutType.OnePage;
                
                // 3.3 基于原页面创建模板,将内容绘制到新尺寸页面
                PdfTemplate template = page.CreateTemplate();
                template.Draw(newPage, new PointF(0, 0), layout);
            }

            // 4. 保存调整后的PDF文件
            newPdf.SaveToFile("预设尺寸.pdf");
            
            // 5. 释放资源
            originPdf.Close();
            newPdf.Close();
        }
    }
}

代码说明

  • PdfDocument:分别实例化 “原始 PDF” 和 “新 PDF”,避免直接修改原文件导致数据丢失;
  • PdfPageSize.A1:内置标准尺寸枚举,支持 A0-A4、Letter、Legal 等常用尺寸,无需手动换算;
  • PdfTextLayout:设置 Layout = PdfLayoutType.OnePage 是核心,可让原页面内容自动缩放并完整适配新页面尺寸;
  • PdfTemplate:将原页面内容封装为模板,再绘制到新尺寸页面,是实现 “内容适配尺寸” 的关键载体。

场景2:将现有 PDF 修改为自定义页面尺寸

适用于非标准尺寸需求(如 6.5×8.5 英寸),通过 PdfUnitConvertor 完成英寸到点的自动换算,避免手动计算误差。

using Spire.Pdf;
using Spire.Pdf.Graphics;
using System.Drawing;

namespace ChangePageSizeToCustomPaperSize
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载原始PDF文档
            PdfDocument originPdf = new PdfDocument();
            originPdf.LoadFromFile("Sample.pdf"); // 替换为你的PDF文件路径

            // 2. 创建新PDF文档存储调整后的内容
            PdfDocument newPdf = new PdfDocument();

            // 3. 初始化单位转换器,实现英寸→点的自动换算
            PdfUnitConvertor unitCvtr = new PdfUnitConvertor();
            // 3.1 换算自定义尺寸:6.5英寸(宽)、8.5英寸(高)→ 点(Point)
            float width = unitCvtr.ConvertUnits(6.5f, PdfGraphicsUnit.Inch, PdfGraphicsUnit.Point);
            float height = unitCvtr.ConvertUnits(8.5f, PdfGraphicsUnit.Inch, PdfGraphicsUnit.Point);
            // 3.2 封装为SizeF对象,作为新页面的自定义尺寸
            SizeF customSize = new SizeF(width, height);

            // 4. 遍历原始PDF页面,逐页绘制到自定义尺寸页面
            foreach (PdfPageBase page in originPdf.Pages)
            {
                // 4.1 新增自定义尺寸的页面(边距设为0)
                PdfPageBase newPage = newPdf.Pages.Add(customSize, new PdfMargins(0));
                
                // 4.2 设置单页适配布局,保证内容完整缩放
                PdfTextLayout layout = new PdfTextLayout();
                layout.Layout = PdfLayoutType.OnePage;
                
                // 4.3 创建原页面模板并绘制到新页面
                PdfTemplate template = page.CreateTemplate();
                template.Draw(newPage, new PointF(0, 0), layout);
            }

            // 5. 保存自定义尺寸的PDF文件
            newPdf.SaveToFile("自定义尺寸.pdf");
            
            // 6. 释放资源
            originPdf.Close();
            newPdf.Close();
        }
    }
}

代码说明

  • PdfUnitConvertor:内置单位转换工具,支持 Inch(英寸)、Millimeter(毫米)、Point(点)、Centimeter(厘米)等单位互转;
  • ConvertUnits 方法:参数依次为 “数值、原单位、目标单位”,无需手动计算 “1 英寸 = 72 点” 的换算关系,降低出错概率;
  • SizeF:封装自定义宽高,作为 Pages.Add 方法的尺寸参数,适配任意非标准页面尺寸需求。

三、注意事项

  • 单位一致性:修改尺寸时需确保宽高单位统一(均为点),避免因单位换算错误导致尺寸偏差。
  • 内容适配PdfLayoutType.OnePage 会自动缩放内容适配新尺寸,若需保持内容原比例,无需额外调整;若需手动控制缩放比例,可结合 ScaleTransform 方法补充调整。
  • 兼容性:该类库生成的 PDF 兼容主流阅读器(Adobe Acrobat、Chrome、Edge等),但复杂PDF(含表单/批注)修改后需验证格式完整性。
  • 资源释放:使用 Close() 方法释放 PdfDocument 资源,避免因文件占用导致保存失败。

该方案无需依赖外部工具,纯代码实现 PDF 页面尺寸调整,适合 .NET 开发者集成到文档处理系统中,在中小规模 PDF 尺寸调整场景中具备较高的实用性和稳定性。

到此这篇关于C#使用Spire.PDF for .NET实现设置或修改PDF页面尺寸的文章就介绍到这了,更多相关C#设置或修改PDF页面尺寸内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • C#结合AForge实现摄像头录像

    C#结合AForge实现摄像头录像

    最近由于兴趣学习了下在C#上使用AForge录制摄像头视频并压缩编码。总体上来说这个第三方.net视觉开发库还是比较稳定的
    2017-09-09
  • 基于C#后台调用跨域MVC服务及带Cookie验证的实现

    基于C#后台调用跨域MVC服务及带Cookie验证的实现

    本篇文章介绍了,基于C#后台调用跨域MVC服务及带Cookie验证的实现。需要的朋友参考下
    2013-04-04
  • C#6.0中你可能不知道的新特性总结

    C#6.0中你可能不知道的新特性总结

    C# 6 已经出来很久了,但最近发现真的有必要整理下,下面这篇文章主要给大家介绍了关于C#6.0中一些你可能不知道的新特性的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起看看吧。
    2018-04-04
  • C# WinForm实现自动更新程序的方法详解

    C# WinForm实现自动更新程序的方法详解

    这一篇就着重写一下客户端的代码,客户端主要实现的有:启动后检测本地的xml文件,然后发送到服务器获取需要更新的文件以及版本列表,感兴趣的小伙伴可以了解一下
    2022-10-10
  • Unity报错InvalidOperationException: out of sync的解决

    Unity报错InvalidOperationException: out of sync的解决

    今天在做个东西,发现报错,特此来记录一下,本文介绍了Unity报错InvalidOperationException: out of sync的解决,感兴趣的可以了解一下
    2021-05-05
  • C#简单配置类及数据绑定

    C#简单配置类及数据绑定

    这篇文章主要介绍了C#简单配置类及数据绑定,原理比较简单,适用于一些小型项目。主要实现保存配置到json文件、从文件或实例加载配置类的属性值、数据绑定到界面控件的功能,需要的朋友可以参考一下
    2021-11-11
  • C#游戏开发之实现俄罗斯方块游戏

    C#游戏开发之实现俄罗斯方块游戏

    这篇文章主要为大家详细介绍了C#如何实现经典俄罗斯方块游戏,文中的示例代码讲解详细,对我们学习C#有一定的帮助,感兴趣的小伙伴可以跟随小编一起了解一下
    2023-01-01
  • WPF的ListView控件自定义布局用法实例

    WPF的ListView控件自定义布局用法实例

    这篇文章主要介绍了WPF的ListView控件自定义布局的方法,结合实例形式分析了WPF中ListView控件的布局方法,需要的朋友可以参考下
    2016-07-07
  • Winform开发中使用下拉列表展示字典数据的几种方式

    Winform开发中使用下拉列表展示字典数据的几种方式

    这篇文章介绍了Winform开发中使用下拉列表展示字典数据的几种方式,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-09-09
  • 结构体和联合体的区别及说明

    结构体和联合体的区别及说明

    文章主要介绍了C语言中的结构体和联合体,结构体是一种自定义的复合数据类型,可以包含多个成员,每个成员可以是不同的数据类型,联合体是一种特殊的数据结构,可以在内存中共享同一段存储空间来存储不同类型的数据
    2025-01-01

最新评论