C#代码实现获取PDF页面尺寸,方向和旋转角度

 更新时间:2026年05月12日 14:34:36   作者:2501_93070778  
在某些情况下,检查 PDF 页面的尺寸、方向和旋转角度是文档质量控制的一部分,本文将介绍如何在 C# 中获取 PDF 页面尺寸、检测页面方向以及读取页面旋转角度,有需要的小伙伴可以了解下

在某些情况下,检查 PDF 页面的尺寸、方向和旋转角度是文档质量控制的一部分。例如,在发布或分发文档之前,可能需要验证这些信息,以确保文档中的所有页面都能正确显示。本文将介绍如何在 C# 中获取 PDF 页面尺寸、检测页面方向以及读取页面旋转角度。

环境准备

开始之前,需要在 .NET 项目中添加 PDF 处理库的 DLL 引用。可以通过下载安装包手动添加,也可以直接使用 NuGet 安装相关组件。

PM> Install-Package Spire.PDF 

在 C# 中获取 PDF 页面尺寸

常见的 PDF 处理库通常提供页面宽度和高度属性,可用于获取 PDF 页面的尺寸信息,默认单位一般为 point(磅)。如果需要将默认单位转换为其他单位(如厘米、毫米或英寸),可以借助单位转换工具类完成。下面是具体步骤:

  1. 创建 PdfDocument 实例。
  2. 使用 PdfDocument.LoadFromFile() 方法加载 PDF 文件。
  3. 通过 PdfDocument.Pages[] 获取指定页面。
  4. 使用页面对象的宽度和高度属性获取 PDF 页面的尺寸信息。
  5. 创建单位转换对象,并通过 ConvertUnits() 方法将 point 单位转换为其他计量单位。
  6. 将页面尺寸信息写入 StringBuilder,最后保存为 TXT 文件。

示例代码如下:

using System.Text;
using Spire.Pdf;
using Spire.Pdf.Graphics;

namespace 获取PDF页面尺寸
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PdfDocument 对象
            PdfDocument pdf = new PdfDocument();

            // 从磁盘加载 PDF 文件
            pdf.LoadFromFile("SamplePDF.pdf");

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

            // 获取页面宽度和高度(单位:point/磅)
            float pointWidth = page.Size.Width;
            float pointHeight = page.Size.Height;

            // 创建 PdfUnitConvertor 对象用于单位转换
            PdfUnitConvertor unitCvtr = new PdfUnitConvertor();

            // 将单位从 point 转换为 pixel(像素)
            float pixelWidth = unitCvtr.ConvertUnits(pointWidth, PdfGraphicsUnit.Point, PdfGraphicsUnit.Pixel);
            float pixelHeight = unitCvtr.ConvertUnits(pointHeight, PdfGraphicsUnit.Point, PdfGraphicsUnit.Pixel);

            // 将单位从 point 转换为 inch(英寸)
            float inchWidth = unitCvtr.ConvertUnits(pointWidth, PdfGraphicsUnit.Point, PdfGraphicsUnit.Inch);
            float inchHeight = unitCvtr.ConvertUnits(pointHeight, PdfGraphicsUnit.Point, PdfGraphicsUnit.Inch);

            // 将单位从 point 转换为 centimeter(厘米)
            float centimeterWidth = unitCvtr.ConvertUnits(pointWidth, PdfGraphicsUnit.Point, PdfGraphicsUnit.Centimeter);
            float centimeterHeight = unitCvtr.ConvertUnits(pointHeight, PdfGraphicsUnit.Point, PdfGraphicsUnit.Centimeter);

            // 创建 StringBuilder 实例
            StringBuilder content = new StringBuilder();

            // 添加页面尺寸信息
            content.AppendLine("文件页面尺寸(单位:point)为(宽:" + pointWidth + "pt,高:" + pointHeight + "pt)。");
            content.AppendLine("文件页面尺寸(单位:pixel)为(宽:" + pixelWidth + "pixel,高:" + pixelHeight + "pixel)。");
            content.AppendLine("文件页面尺寸(单位:inch)为(宽:" + inchWidth + "inch,高:" + inchHeight + "inch)。");
            content.AppendLine("文件页面尺寸(单位:centimeter)为(宽:" + centimeterWidth + "cm,高:" + centimeterHeight + "cm)。");

            // 保存为 TXT 文件
            File.WriteAllText("GetPageSize.txt", content.ToString());
        }
    }
}

在 C# 中检测 PDF 页面方向

检测 PDF 页面方向时,可以通过比较页面的宽度和高度来判断。如果页面宽度大于高度,则页面方向为横向(Landscape);否则为纵向(Portrait)。具体步骤如下:

  1. 创建 PdfDocument 实例。
  2. 使用 PdfDocument.LoadFromFile() 方法加载 PDF 文件。
  3. 通过 PdfDocument.Pages[] 获取指定页面。
  4. 使用页面对象的宽度和高度属性获取 PDF 页面的尺寸信息。
  5. 比较页面宽度和高度的值,以判断页面方向。
  6. 使用 Console.WriteLine() 方法输出结果。

示例代码如下:

using Spire.Pdf;

namespace 检测PDF页面方向
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PdfDocument 对象
            PdfDocument pdf = new PdfDocument();

            // 从磁盘加载 PDF 文件
            pdf.LoadFromFile("SamplePDF.pdf");

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

            // 获取页面宽度和高度
            float width = page.Size.Width;
            float height = page.Size.Height;

            // 比较页面宽度和高度的值
            if (width > height)
            {
                Console.WriteLine("页面方向为横向(Landscape)。");
            }
            else
            {
                Console.WriteLine("页面方向为纵向(Portrait)。");
            }
        }
    }
}

在 C# 中检测 PDF 页面旋转角度

PDF 页面的旋转角度可以通过 PdfPageBase.Rotation 属性获取。具体步骤如下:

  1. 创建 PdfDocument 实例。
  2. 使用 PdfDocument.LoadFromFile() 方法加载 PDF 文件。
  3. 通过 PdfDocument.Pages[] 获取指定页面。
  4. 使用 PdfPageBase.Rotation 属性获取页面的旋转角度,并将结果转换为字符串。
  5. 使用 Console.WriteLine() 方法输出结果。

示例代码如下:

using Spire.Pdf;

namespace 获取PDF页面旋转角度
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PdfDocument 对象
            PdfDocument pdf = new PdfDocument();

            // 从磁盘加载 PDF 文件
            pdf.LoadFromFile("E:\\PythonPDF\\Sample.pdf");

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

            // 获取当前页面的旋转角度
            PdfPageRotateAngle rotationAngle = page.Rotation;
            string rotation = rotationAngle.ToString();

            // 输出页面旋转角度信息
            Console.WriteLine("当前页面的旋转角度为:" + rotation);
        }
    }
}

知识扩展

在C#中获取PDF页面的尺寸、方向和旋转角度,可以使用免费开源的 PdfPig 库,它无需安装Adobe Reader,跨平台且易于使用。以下代码演示了如何读取PDF文件,提取每个页面的宽度、高度、计算方向(横向/纵向)以及读取旋转角度。

1. 安装 PdfPig

在Visual Studio中打开“包管理器控制台”或使用 .NET CLI:

dotnet add package PdfPig

Install-Package PdfPig

2. 代码示例

using System;
using System.IO;
using UglyToad.PdfPig;
using UglyToad.PdfPig.Content;
class Program
{
    static void Main(string[] args)
    {
        string filePath = @"C:\test\example.pdf";
        GetPdfPageInfo(filePath);
    }
    static void GetPdfPageInfo(string pdfPath)
    {
        if (!File.Exists(pdfPath))
        {
            Console.WriteLine("文件不存在!");
            return;
        }
        using (PdfDocument document = PdfDocument.Open(pdfPath))
        {
            for (int i = 0; i < document.NumberOfPages; i++)
            {
                Page page = document.GetPage(i + 1); // 页码从1开始
                // 获取页面尺寸(单位:点,1点 = 1/72英寸)
                double width = page.Width;
                double height = page.Height;
                // 获取旋转角度(0, 90, 180, 270)
                int rotation = page.Rotation.Value;  // Rotation 是可空类型,一般为90度的整数倍
                // 计算方向(基于原始宽高,未考虑旋转)
                string orientation = (width > height) ? "横向 (Landscape)" : "纵向 (Portrait)";
                // 输出信息
                Console.WriteLine($"--- 第 {i + 1} 页 ---");
                Console.WriteLine($"原始尺寸: {width} x {height} 点 (约 {width/72:F2} x {height/72:F2} 英寸)");
                Console.WriteLine($"方向: {orientation}");
                Console.WriteLine($"旋转角度: {rotation} 度");
                Console.WriteLine();
                // 如果需要考虑旋转后的实际显示方向,可以结合旋转角度判断
                bool isRotated = (rotation % 180 != 0);
                string effectiveOrientation = (isRotated ? (height > width ? "横向" : "纵向") : orientation);
                Console.WriteLine($"考虑旋转后的实际显示方向: {effectiveOrientation}\n");
            }
        }
    }
}

3. 输出示例

--- 第 1 页 ---
原始尺寸: 595.0 x 842.0 点 (约 8.26 x 11.69 英寸)
方向: 纵向 (Portrait)
旋转角度: 0 度

--- 第 2 页 ---
原始尺寸: 842.0 x 595.0 点 (约 11.69 x 8.26 英寸)
方向: 横向 (Landscape)
旋转角度: 0 度

--- 第 3 页 ---
原始尺寸: 595.0 x 842.0 点 (约 8.26 x 11.69 英寸)
方向: 纵向 (Portrait)
旋转角度: 90 度
考虑旋转后的实际显示方向: 横向

4. 关键说明

  • 尺寸单位:PdfPig 返回的宽度和高度以“点”(Point)为单位(1点 = 1/72英寸)。
  • 旋转角度:通过 page.Rotation.Value 获取,值为 0、90、180 或 270。Rotation 是可空类型,若不存在则默认 0。
  • 方向判断:原始方向由宽度 > 高度判定,但旋转 90° 或 270° 后实际显示的方向会互换。示例中给出了计算有效方向的方法。
  • 其他页面框:PDF 除了 /MediaBox 还有 /CropBox/TrimBox 等,page.Width 和 page.Height 默认返回的是 /CropBox(如果存在),否则返回 /MediaBox。如需获取特定框,可通过 page.GetMediaBox() 等方法。

总结

本文介绍了如何在 C# 中获取 PDF 页面的尺寸、方向以及旋转角度。通过读取页面的宽度、高度和旋转属性,开发者可以快速分析 PDF 页面布局,并根据实际需求进行文档检查、页面处理或自动化管理。

此外,文章还演示了如何将页面尺寸从默认的 point(磅)单位转换为像素、英寸和厘米等常用单位,以及如何通过简单的宽高比较判断页面是横向还是纵向。借助这些方法,可以更方便地完成 PDF 文档的质量检测与页面信息提取工作。

以上就是C#代码实现获取PDF页面尺寸,方向和旋转角度的详细内容,更多关于C#获取PDF页面信息的资料请关注脚本之家其它相关文章!

相关文章

  • 浅谈Java与C#的一些细微差别

    浅谈Java与C#的一些细微差别

    说起C#和Java这两门语言(语法,数据类型 等),个人以为,大概有90%以上的相似,甚至可以认为几乎一样。但是在工作中,我也发现了一些细微的差别
    2013-11-11
  • C# 如何合并和拆分PDF文件

    C# 如何合并和拆分PDF文件

    这篇文章主要介绍了C# 如何合并和拆分PDF文件,帮助大家更好的理解和使用c#,感兴趣的朋友可以了解下
    2021-01-01
  • C#日志存储优化的五种方法

    C#日志存储优化的五种方法

    本文介绍了C#日志存储优化的五种方法,包括日志轮转、压缩存储、远程存储、日志级别控制和日志格式优化,通过合理的配置和优化,可以有效避免日志文件无限增长,节省磁盘空间,提高查询效率和系统性能,需要的朋友可以参考下
    2025-10-10
  • unity3d 对接 workerman 实现联机游戏功能

    unity3d 对接 workerman 实现联机游戏功能

    workerman 是一款开源高性能 PHP 应用容器,他除了用于互联网、即时通讯、APP 开发、硬件通讯、智能家居、物联网等领域的开发外,这篇文章主要介绍了unity3d 对接 workerman 实现联机游戏,需要的朋友可以参考下
    2022-10-10
  • 深入理解C#指针之美

    深入理解C#指针之美

    在C#中,有时候希望通过指针来操作内存,这样可以提高效率。我们可以用unsafe关键字修饰含有指针操作的程序段,感兴趣的小伙伴可以参考一下,希望可以帮到你
    2021-07-07
  • C#文件合并的方法

    C#文件合并的方法

    这篇文章主要介绍了C#文件合并的方法,实例分析了C#基于FileStream操作文件合并的相关技巧,需要的朋友可以参考下
    2015-07-07
  • C#访问及调用类中私有成员与方法示例代码

    C#访问及调用类中私有成员与方法示例代码

    访问一个类的私有成员不是什么好做法,大家也都知道私有成员在外部是不能被访问的,这篇文章主要给大家介绍了关于C#访问及调用类中私有成员与方法的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2018-06-06
  • C# IP地址与整数之间转换的具体方法

    C# IP地址与整数之间转换的具体方法

    这篇文章介绍了C# IP地址与整数之间转换的具体方法,有需要的朋友可以参考一下
    2013-10-10
  • C#将异步改成同步方法示例

    C#将异步改成同步方法示例

    这篇文章主要为大家介绍了C#将异步改成同步方法示例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2024-01-01
  • C#控制台输出进度和百分比的实例代码

    C#控制台输出进度和百分比的实例代码

    C#控制台输出进度和百分比的实例代码,需要的朋友可以参考一下
    2013-03-03

最新评论