C# 将多张图片转换到一个 PDF 文档

在日常开发中,经常需要将多张图片(如 JPG、PNG、BMP 等)合并为一个 PDF 文档,方便存储和分享。本文将介绍如何使用 C# 结合 Spire.PDF for .NET 库实现这一功能,该库提供了简洁的 API,无需依赖 Adobe Acrobat 即可快速操作 PDF。

一、准备工作

Spire.PDF for .NET是一个专业的PDF处理类库,支持创建、编辑、转换PDF文档,同时提供了丰富的图片处理能力,可轻松将图片插入PDF页面。

安装步骤如下:

推荐通过 NuGet 包管理器安装:

  • 在 Visual Studio 中右键点击项目,选择"管理 NuGet 包"
  • 搜索"Spire.PDF"并安装
  • 安装完成后,引用命名空间:using Spire.Pdf; 和 using Spire.Pdf.Graphics;

二、核心实现步骤

功能需求

将指定文件夹中的所有图片(支持JPG、PNG、BMP等格式)按顺序合并为一个PDF,每张图片占一页,且页面大小自适应图片尺寸。

完整代码示例

csharp 复制代码
using Spire.Pdf;
using Spire.Pdf.Graphics;
using System.Drawing;

namespace ConvertMultipleImagesIntoPdf
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建PdfDocument对象
            PdfDocument pdf = new PdfDocument();

            // 将页边距设置为0
            pdf.PageSettings.SetMargins(0);

            // 获取图片存放的文件夹
            DirectoryInfo folder = new DirectoryInfo(@"C:\Users\Administrator\Desktop\Images");

            // 遍历图片
            foreach (FileInfo file in folder.GetFiles())
            {
                Image image = Image.FromFile(file.FullName);

                // 获取图片尺寸
                float width = image.PhysicalDimension.Width;
                float height = image.PhysicalDimension.Height;

                // 添加与图片大小相同的PDF页面
                PdfPageBase page = pdf.Pages.Add(new SizeF(width, height));

                // 将图片绘制到页面
                PdfImage pdfImage = PdfImage.FromImage(image);
                page.Canvas.DrawImage(pdfImage, 0, 0, pdfImage.Width, pdfImage.Height);
            }
      
            // 保存PDF文档
            pdf.SaveToFile("CombinaImagesToPdf.pdf");
            pdf.Dispose();
        }
    }
}

代码解析

  1. 参数配置:指定图片文件夹路径,可根据实际需求修改。
  2. PDF页面创建:创建一个与图片尺寸完全相同的 PDF 页面(确保页面大小适配图片,无拉伸或裁剪)
  3. 图片绘制 :page.Canvas.DrawImage() 从页面左上角 (0,0) 开始绘制图片,尺寸与图片原始尺寸一致,最终效果是图片完全覆盖页面。
  4. 释放资源 :Dispose() 手动释放 PdfDocument 对象占用的资源。

三、扩展技巧

1. 固定PDF页面大小

如果需要所有页面使用固定尺寸(如A4),可修改页面创建逻辑:

csharp 复制代码
// 创建A4尺寸页面(210mm×297mm)
PdfPageBase page = pdf.Pages.Add(PdfPageSize.A4);

2. 图片缩放适应页面

若图片尺寸超过页面,可自动缩放:

csharp 复制代码
// 计算缩放比例(确保图片完全显示在页面内)
float scaleX = page.Canvas.ClientSize.Width / pdfImage.Width;
float scaleY = page.Canvas.ClientSize.Height / pdfImage.Height;
float scale = Math.Min(scaleX, scaleY);

// 按比例缩放绘制
page.Canvas.DrawImage(pdfImage, x, y, pdfImage.Width * scale, pdfImage.Height * scale);

结语:通过 Spire.PDF for .NET 库,使用简单代码即可实现图片转 PDF 的功能,相比传统方案(System.Drawing + GDI+)更简洁易用。该方法适用于批量处理图片、生成电子相册、归档扫描件等场景,可根据实际需求扩展更多功能(如添加页码、水印等)。

相关推荐
sleveen3 小时前
新增办理动词只写 Core:SailFlow 动作骨架、同事务信封与 Sync 钩子自锁治理
开源·.net·工作流·oa引擎
Jeff-Tsai1 天前
Day 26:数值语义、多币种与计量单位
.net·架构设计·erp·definition-driven
风云2 天前
两条 Pipe、五个命门:Vane.NET 内核为什么长这样
开源·网络编程·.net·架构设计·vane.net
zdr尽职尽责2 天前
UnityCli 兼容2022版本
ui·unity·ai·c#·游戏引擎
宝桥南山2 天前
Visual Studio 2026新特性 - 可以直接连接DeepSeek(使用Custom Endpoint Provider配置项)
ide·microsoft·微软·aigc·.net·visual studio
Jeff-Tsai2 天前
Day 25:审计轨迹与变更的前后值
.net·架构设计·erp·definition-driven
IT规划师2 天前
Redis 核心机制 | 事务:执行序列的原子性、乐观锁与 8.x 条件写
redis·.net
Jeff-Tsai3 天前
Day 24:权限的三轴:动作、行与列
.net·架构设计·erp·definition-driven
BruceNeter3 天前
C# winform卡死问题分析1——线程池子线程创建句柄
c#·.net