如何在C#中将图像转换为PDF [代码示例教程]

我应该选择哪个 .NET Framework 版本？

IronPDF 支持多种 .NET 版本，包括 .NET Framework 4.6.2+、.NET Core 3.1+ 和 .NET 5/6/7/8+。 对于新项目，建议使用最新的 .NET LTS（长期支持）版本，以获得最佳性能和安全更新。 该库在Windows 、 Linux和macOS平台上也能无缝运行。

接下来，在此项目中安装 IronPDF NuGet 包以使用它的功能。 IronPDF 的最大优点在于它无需依赖专有 API，从而消除了生成 PDF 文档的繁琐步骤。它支持将 HTML、JS、CSS、JPG、PNG、GIF 和 SVG 等开放标准文档类型渲染成像素级完美的 PDF文件。 简而言之，它利用了开发人员已经具备的技能。

哪些是替代安装方法？

您还可以通过以下方式安装 IronPDF：

• NuGet 程序包管理器界面：右键单击您的项目，选择"管理 NuGet 程序包"，搜索"IronPdf"，然后单击"安装"。 -包参考：添加<PackageReference Include="IronPdf" Version="*" />添加到你的 .csproj 文件中 -直接下载：从IronPDF 网站下载 DLL 文件并手动引用。 -命令行：在终端中使用dotnet add package IronPdf命令。

对于Azure 部署，您可能需要进行额外的配置。 同样， Docker 环境也需要特定的设置步骤。

支持哪些图像格式？

IronPDF支持多种图像格式的PDF转换：

• JPEG/JPG ：最常见的照片格式
• PNG ：非常适合用于带有透明度的图像。
• GIF ：包括动画 GIF（使用第一帧）
• BMP ：Windows 位图格式
• TIFF ：包括多页 TIFF 文件
• SVG ：可缩放矢量图形 WebP ：现代网络图像格式

示例鸟类图片，展示了一只色彩斑斓的小鸟栖息在树枝上，用于演示 PDF 转换的图像质量 示例图片

要使用该库，请在program.cs文件中引用 IronPDF 库。在文件顶部写入以下代码片段：

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

接下来，在主函数内编写以下代码。 这将把 JPG 文件转换为 PDF 文件：

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);

    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";

    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");

    Console.WriteLine("PDF created successfully!");
}

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);

    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";

    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");

    Console.WriteLine("PDF created successfully!");
}

ImageBehavior如何影响输出？

在上面的代码示例中，IronPDF 提供的 ImageToPdfConverter 类用于图像转换。 ImageToPdf 方法可用于从图像创建 PDF 文档。 它接受图像文件和 System.Drawing 对象作为输入。

静态方法 ImageToPdf 将单个图像文件转换为匹配尺寸的相同 PDF 文档。 它接受两个参数：图像路径和图像行为（图像如何在纸上显示）。 ImageBehavior枚举提供了以下几个选项：

• CropPage ：设置 PDF 页面大小以匹配图像尺寸
• CenteredOnPage ：将图像居中显示在页面上，不调整图像大小
• FitToPage ：缩放图像以适应页面边距
• FitToPageAndMaintainAspectRatio ：缩放时保持宽高比

Imaging.ImageBehavior.CropPage 将纸张尺寸设置为等于图像尺寸。默认页面尺寸是 A4。您可以通过以下代码行设置它：

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

您还可以根据特定需求设置自定义页面尺寸：

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

有哪些纸张尺寸可供选择？

提供了多种页面尺寸选项，您可以根据需要设置它们。 IronPDF 支持所有标准纸张尺寸：

• A 系列：A0、A1、A2、A3、A4（默认）、A5、A6、A7、A8、A9、A10
• B系列：B0至B10 -美国尺寸：Letter、Legal、Ledger、Tabloid、Executive 其他：Foolscap、Crown、Demy、Royal 等

您还可以为 PDF 配置页面方向（纵向或横向）和自定义边距。

如何筛选不同格式的图像？

在上述代码中，System.IO.Directory.EnumerateFiles 检索指定文件夹中可用的所有文件。 Where 子句从该文件夹中过滤所有 JPG 图像并将它们存储在 imageFiles 集合中。 如果您有 PNG 或任何其他图像格式，只需将其添加到Where查询中即可：

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

您还可以使用更简洁的方法，并提供一系列扩展：

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

PDF 文件中图片的排列顺序是什么？

默认情况下，图像按照文件系统返回的顺序显示，该顺序可能不是按字母顺序排列的。 为了控制顺序，您可以对文件进行排序：

-按字母顺序： imageFiles.OrderBy(f => f) -按创建日期排序： imageFiles.OrderBy(f => new FileInfo(f).CreationTime) -按文件大小排序： imageFiles.OrderBy(f => new FileInfo(f).Length) -自定义排序：使用自定义比较函数

下一行将获取所有图像并将它们组合成单个 PDF 文档。 在PDF文件中，每张图片都会单独占一页。

我可以指定打印机设置吗？

PdfDocument 类提供的 Print 方法将使用默认打印机打印文档。 它还提供更改打印机名称和其他设置的选项。 高级打印选项：

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

有关打印文档的更多详细信息，请访问此PDF 打印示例。 您还可以探索适用于企业环境的网络打印方案。

哪里可以了解更多关于IronPDF的信息？

IronPDF提供了多种实用功能。 探索以下资源：

• 访问IronPDF 主页查看产品概述
• 浏览完整文档，获取详细指南 查看代码示例以了解实际应用。
• 阅读教程，逐步学习
• 请参阅API 参考文档了解技术详情 加入IronPDF 社区获取支持

具体使用案例，请参阅：

• 将网页内容的HTML 转换为 PDF
• 用于保护的PDF 安全功能
• 针对大型作业的性能优化
• Azure 和 AWS云部署指南

IronPDF 的价格是多少？

IronPDF是Iron软件套件的一部分。 Iron Suite 套件包含其他实用产品，例如用于 Excel 操作的IronXL 、用于条形码生成的IronBarcode 、用于文本识别的IronOCR以及用于网络数据提取的IronWebscraper 。 您可以通过购买完整的Iron Suite节省高达250%的费用，因为您目前可以用两个的价格购买全部五个产品。 请访问许可详情页面了解更多信息。

IronPDF 提供： -免费开发许可，可用于测试 专业许可证起价 749 美元 -免版税再分发选项 提供SaaS 和 OEM 许可

• 30 天退款保证
• 一年免费支持和更新

使用试用许可证即可免费试用 IronPDF 30 天，或者了解适合您团队的许可选项。