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

2025-10-21 14:53:24 作者：咕白m625

在日常开发中,经常需要将多张图片合并为一个 PDF 文档,方便存储和分享,下面我们就来看看如何使用C# 结合 Spire.PDF for .NET 库实现这一功能,需要的可以参考一下

在日常开发中，经常需要将多张图片（如 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，每张图片占一页，且页面大小自适应图片尺寸。

完整代码示例

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();
        }
    }
}

代码解析

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

三、扩展技巧

1. 固定PDF页面大小

如果需要所有页面使用固定尺寸（如A4），可修改页面创建逻辑：

// 创建A4尺寸页面（210mm×297mm）
PdfPageBase page = pdf.Pages.Add(PdfPageSize.A4);

2. 图片缩放适应页面

若图片尺寸超过页面，可自动缩放：

// 计算缩放比例（确保图片完全显示在页面内）
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);

四、方法补充

C# 将单张图片转换为PDF文档

Free Spire.PDF for .NET提供的图片转PDF的方法是将加载的图片绘制到PDF页面上实现的，主要步骤如下：

创建一个 PDF文档，然后将其页边距设置为0。
使用 Image.FromFile() 方法加载图片，然后获取图片的宽度和高度。
通过 PdfDocument.Pages.Add() 方法添加一个与图片大小相同的PDF页面。
根据图片创建 PdfImage 对象。
使用 PdfPageBase.Canvas.DrawImage() 方法在PDF页面上绘制PdfImage对象。
使用 PdfDocument.SaveToFile() 方法保存生成的 PDF 文档。

示例代码：

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

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

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

            //加载图片
            Image image = Image.FromFile(@"C:\Users\Administrator\Desktop\work.jpg");

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

            //创建PdfImage对象
            PdfImage pdfImage = PdfImage.FromFile(@"C:\Users\Administrator\Desktop\work.jpg");

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

            //在页面上绘制图片
            page.Canvas.DrawImage(pdfImage, 0, 0, pdfImage.Width, pdfImage.Height);

            //保存PDF
            pdf.SaveToFile("图片转Pdf.pdf");
        }
    }
}

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

Free Spire.PDF for .NET也可以将一个文件夹中的多张图片绘制到一个PDF文档的不同页面上，主要步骤如下：

创建一个 PDF文档，然后将其页边距设置为0。
获取存储图片的文件夹。
遍历文件夹中的每个图像文件，并获取每一张图片的宽度和高度。
通过 PdfDocument.Pages.Add() 方法在PDF文档中添加与图片大小相同的PDF页面。
使用 PdfPageBase.Canvas.DrawImage() 方法在页面上绘制各个图片。
使用 PdfDocument.SaveToFile() 方法保存生成的PDF文档。