C#代码实现旋转PDF页面功能

2026-04-21 08:18:53 作者：2501_93070778

在处理 PDF 文档时,有时需要对页面进行旋转,本文将以Spire.PDF for .NET为例,向您介绍如何使用C#代码实现PDF页面旋转,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下

在处理 PDF 文档时，有时需要对页面进行旋转。例如，当文档中存在方向不正确的页面时，可以通过旋转来提升阅读体验。下面介绍在 .NET 环境下，使用 C# 或 VB.NET 实现 PDF 页面旋转的基本方法。

PDF 页面旋转通常以 90 度为单位进行，可设置为 0、90、180 或 270 度。本文将以Spire.PDF for .NET为例，向您介绍如何使用C#代码实现PDF页面旋转。

环境准备

在开始之前，需要在 .NET 项目中引入相关的 PDF 处理库。你可以将对应包中的 DLL 文件添加为项目引用，或者通过 NuGet 进行安装，以完成基础环境配置。

PM> Install-Package Spire.PDF

旋转指定页面

实现步骤如下：

创建 PdfDocument 类的实例。
加载 PDF 文档。
根据索引（从 0 开始）获取需要处理的页面。
读取该页面当前的旋转角度。
在原有角度基础上增加所需的旋转角度。
将新的旋转角度应用到该页面。
保存修改后的文档。

示例代码参考：

using Spire.Pdf;

namespace RotatePdfPage
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PdfDocument 实例
            PdfDocument pdf = new PdfDocument();
            // 加载 PDF 文档
            pdf.LoadFromFile("Sample.pdf");

            // 获取第一页
            PdfPageBase page = pdf.Pages[0];

            // 获取页面的原始旋转角度
            int rotation = (int)page.Rotation;

            // 在原有旋转角度的基础上顺时针旋转 180 度
            rotation += (int)PdfPageRotateAngle.RotateAngle180;
            page.Rotation = (PdfPageRotateAngle)rotation;

            // 保存结果文档
            pdf.SaveToFile("Rotate.pdf");
        }
    }
}

旋转所有页面

如果需要统一调整整份文档的方向，可以按以下步骤操作：

创建 PdfDocument 类的实例。
加载 PDF 文档。
遍历文档中的每一页。
获取每一页当前的旋转角度。
在原有角度基础上增加所需的旋转角度。
将新的旋转角度应用到每一页。
保存修改后的文档。

示例代码参考：

using Spire.Pdf;

namespace RotateAllPdfPages
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PdfDocument 实例
            PdfDocument pdf = new PdfDocument();
            // 加载 PDF 文档
            pdf.LoadFromFile("Sample.pdf");

            foreach (PdfPageBase page in pdf.Pages)
            {
                // 获取页面的原始旋转角度
                int rotation = (int)page.Rotation;
                // 在原有旋转角度的基础上顺时针旋转 180 度
                rotation += (int)PdfPageRotateAngle.RotateAngle180;
                page.Rotation = (PdfPageRotateAngle)rotation;
            }

            // 保存结果文档
            pdf.SaveToFile("RotateAll.pdf");
        }
    }
}

方法补充

使用 Spire.PDF for .NET

Spire.PDF 是一个功能强大的商业库，其API设计直观，适合快速集成。

1. 安装通过NuGet包管理器安装Spire.PDF：

Install-Package Spire.PDF

2. 旋转指定页面下面的代码演示了如何将PDF文档的第一页顺时针旋转180度：

using Spire.Pdf;
class Program
{
    static void Main(string[] args)
    {
        // 创建PdfDocument对象
        PdfDocument pdf = new PdfDocument();
        // 加载PDF文档
        pdf.LoadFromFile("示例.pdf");
        // 获取第一页
        PdfPageBase page = pdf.Pages[0];
        // 获取页面的原始旋转角度
        int rotation = (int)page.Rotation;
        // 在原有角度基础上顺时针旋转180度
        rotation += (int)PdfPageRotateAngle.RotateAngle180;
        page.Rotation = (PdfPageRotateAngle)rotation;
        // 保存结果文档
        pdf.SaveToFile("旋转PDF页面.pdf");
        pdf.Close();
    }
}

3. 旋转所有页面要旋转整个PDF文档的所有页面，可以遍历pdf.Pages集合，并为每一页应用旋转：

using Spire.Pdf;
class Program
{
    static void Main(string[] args)
    {
        // 创建PdfDocument对象
        PdfDocument pdf = new PdfDocument();
        // 加载PDF文档
        pdf.LoadFromFile("示例.pdf");
        // 遍历每一页
        foreach (PdfPageBase page in pdf.Pages)
        {
            // 获取页面的原始旋转角度
            int rotation = (int)page.Rotation;
            // 在原有角度基础上顺时针旋转90度
            rotation += (int)PdfPageRotateAngle.RotateAngle90;
            page.Rotation = (PdfPageRotateAngle)rotation;
        }
        // 保存结果文档
        pdf.SaveToFile("旋转PDF.pdf");
        pdf.Close();
    }
}

注意：Spire.PDF 是商业库，免费版本在生成文档时会有限制（如水印、页数限制）。如需在生产环境中使用，请购买授权或申请临时许可证。

使用 Aspose.PDF for .NET

Aspose.PDF 是业界公认的工业级PDF处理方案，功能强大且精细。

1. 安装通过NuGet包管理器安装Aspose.PDF：

Install-Package Aspose.PDF

2. 旋转特定页面下面的示例演示了如何将PDF文档的奇数页（第1, 3, 5页）旋转180度：

using Aspose.Pdf.Facades;
class Program
{
    static void Main(string[] args)
    {
        // 初始化PdfPageEditor
        PdfPageEditor pEdit = new PdfPageEditor();
        // 绑定源PDF
        pEdit.BindPdf("input.pdf");
        // 指定要旋转的页面（第1, 3, 5页）
        pEdit.ProcessPages = new int[] { 1, 3, 5 };
        // 设置旋转角度
        pEdit.Rotation = 180;
        // 保存修改后的PDF
        pEdit.Save("output_rotated.pdf");
    }
}

3. 批量处理并裁剪页面Aspose.PDF 还支持组合操作，如先旋转后裁剪：

string[] pdfFiles = Directory.GetFiles(@"C:\Docs\ToProcess", "*.pdf");
foreach (var file in pdfFiles)
{
    // 1. 旋转第一页
    var rotate = new RotateOptions { Rotation = Rotation.on90, Pages = new[] { 1 } };
    rotate.AddInput(new FileDataSource(file));
    rotate.AddOutput(new FileDataSource(file.Replace(".pdf", "_rotated.pdf")));
    optimizer.Process(rotate);
    // 2. 在旋转后的输出中裁剪第一页
    var crop = new CropOptions { CropBox = new Rectangle(30, 30, 400, 600), Pages = new[] { 1 } };
    crop.AddInput(new FileDataSource(file.Replace(".pdf", "_rotated.pdf")));
    crop.AddOutput(new FileDataSource(file.Replace(".pdf", "_final.pdf")));
    optimizer.Process(crop);
}

使用 Syncfusion PDF Library

Syncfusion 的 PDF 库提供了成熟的免费社区版，适合小型项目。

1. 安装通过NuGet包管理器安装Syncfusion.Pdf.Net.Core：

Install-Package Syncfusion.Pdf.Net.Core

2. 旋转单个页面下面的代码演示了如何旋转PDF文档的第一页：

using Syncfusion.Pdf;
using Syncfusion.Pdf.Parsing;
class Program
{
    static void Main(string[] args)
    {
        // 加载现有PDF文档
        FileStream inputStream = new FileStream("Input.pdf", FileMode.Open, FileAccess.Read);
        PdfLoadedDocument loadedDocument = new PdfLoadedDocument(inputStream);
        // 获取第一页
        PdfLoadedPage page = loadedDocument.Pages[0] as PdfLoadedPage;
        // 将页面旋转90度
        page.Rotation = PdfPageRotateAngle.RotateAngle90;
        // 保存修改后的PDF文档
        FileStream outputStream = new FileStream("Output.pdf", FileMode.Create, FileAccess.Write);
        loadedDocument.Save(outputStream);
        // 关闭文档和文件流
        loadedDocument.Close(true);
        inputStream.Close();
        outputStream.Close();
    }
}

方案对比与选择建议

方案	类型	代码量	难度	费用	适用场景
Spire.PDF	商业	极少	极低	商业	追求开发效率，预算充足的商业项目
Aspose.PDF	商业	较少	低	商业	对转换质量和功能要求极高的企业级项目
Syncfusion	商业	中等	低	商业 (提供免费社区版)	预算有限但需要丰富功能的小型团队

核心注意事项

旋转角度限制：PDF页面旋转通常以90度为基本单位，可设置为0、90、180或270度。
服务器部署考量：若在Web服务器或Linux环境中运行，务必选择不依赖本地Office组件的库。上述推荐的Spire.PDF、Aspose.PDF和Syncfusion均满足此要求。
许可证评估：商业库通常提供功能完整的试用版，建议在购买前用你的实际文档进行充分测试，评估转换质量和性能。

结语

通过以上方法，可以在 .NET 环境中灵活实现对 PDF 页面方向的调整，无论是针对单页还是整份文档，都能高效完成。实际开发中，可以根据具体需求选择合适的处理方式，从而提升文档的可读性与使用体验。在处理批量文档或自动化场景时，这类操作也能够很好地融入到工作流程中，提高整体效率。

到此这篇关于C#代码实现旋转PDF页面功能的文章就介绍到这了,更多相关C#旋转PDF页面内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！