C# 将图像添加到 PDF（开发者教程）

介绍

从开发人员的角度来看，在 PDF 文档中以编程方式添加图像是一项具有挑战性的任务，因为图像格式多种多样，而且操作起来非常复杂。 因此，建议使用 IronPDF C# 库以编程方式将图像添加到 PDF 文档中。 让我们来探讨一下什么是 IronPDF 以及如何有效地使用它。

IronPDF：C# PDF 库

IronPDF C# 库是一个用 C# 编写的 PDF 库，以 PDF 对象模型为目标。 该库为开发人员提供了一种创建、编辑和保存 PDF 文件的方法，而无需严格保持与特定 API（如 Adobe 的 Acrobat）的相关性。 当您不想使用 Adobe Acrobat 或其他单个软件时，可以使用 IronPDF C# 库。

该库为开发人员提供了大量创建工具、用 C# 编辑 PDF 文件例如，在.NET PDF 库中，您可以创建和保存 PDF 文件，以及其他 .NET PDF 库所不具备的功能。 许多开发人员偏爱 IronPDF C# 库，因为它能在 Windows、Linux 和 macOS 平台上提供他们想要的 PDF 库中的所有功能，而且不收取任何费用。! IronPDF 不断增加功能和扩展服务，使其成为满足您 PDF 需求的最佳实用工具。 对于那些需要浏览、搜索和查找的人来说，该库超出了基本要求、从PDF文件中提取数据或创建 PDF 文件。 让我们来看看 IronPDF 是如何用于在 PDF 文档中添加图片的。

创建或打开 C# 项目

要在 PDF 文档中添加图像，建议使用最新版本的 Visual Studio 创建 C# 项目，以获得流畅的体验。

• 打开 Visual Studio。

  

  *Visual Studio 启动用户界面***

• 点击“创建新项目”按钮。

• 从项目模板中选择 "C# 控制台应用程序"，然后点击下一步按钮。 您可以根据自己的需要选择平台。

  

  在 Visual Studio 中创建控制台应用程序

• 接下来，为您的项目命名，然后点击下一步按钮。

• 选择目标 .NET Framework >= .NET Core 3.1 版本，然后点击创建按钮。

  按照上述步骤，您就能轻松创建一个新的 C# 项目。 您可以使用已有的 C# 项目。 只需打开项目并安装 IronPDF 库即可。

安装 IronPDF 库

IronPDF 库可以通过多种方式安装。

• 使用 NuGet 软件包管理器
• 使用软件包管理器控制台

使用 NuGet 软件包管理器

要使用 NuGet 包管理器安装该库，请按照以下步骤操作：

• 从主菜单选项转到 Tools > NuGet Package Manager > Manage NuGet Package for Solution。

  

  导航到NuGet包管理器

• 这将打开 NuGet 包管理器窗口。 转到浏览选项卡，搜索 IronPDF。 选择 IronPdf 库并点击 "安装 "按钮。

  

  从 NuGet 软件包管理器安装 IronPdf 软件包

使用软件包管理器控制台

以下是使用控制台安装 IronPDF 库的步骤。

• 转到软件包管理器控制台(通常位于 Visual Studio).
• 编写以下命令启动 IronPDF 库的安装。

Install-Package IronPdf

它将开始安装，您可以看到安装进度。 安装完成后，您将能很快在项目中使用 IronPDF 库。

库已经安装完毕，现在是编写代码将图像添加到 PDF 文档的时候了。 从导入 IronPDF 命名空间开始。 因此，请在代码文件中编写以下一行：

using IronPdf;

using IronPdf;

Imports IronPdf

在 PDF 文档中添加位图和图像

使用 IronPDF 在 PDF 文档中添加图像有多种方法：直接使用图像文件、将图像转换为字节或使用 System.Drawing.Bitmap。 此外，IronPDF 库支持多种图像格式。

让我们来看看：

using IronPdf;
using System.IO;
using System.Drawing;
/* Example 1: From an Image File or Bytes*/

static void Main(string [] args)
{
    var renderer = new IronPdf.ChromePdfRenderer();

    var pngBinaryData = File.ReadAllBytes("embed_me.png");

    var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(base64bytes);
    var ImgHtml = $"<img src='{ImgDataURI}'>";

    using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);
    pdfdoc.SaveAs("embeded_example_1.pdf");
}

using IronPdf;
using System.IO;
using System.Drawing;
/* Example 1: From an Image File or Bytes*/

static void Main(string [] args)
{
    var renderer = new IronPdf.ChromePdfRenderer();

    var pngBinaryData = File.ReadAllBytes("embed_me.png");

    var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(base64bytes);
    var ImgHtml = $"<img src='{ImgDataURI}'>";

    using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);
    pdfdoc.SaveAs("embeded_example_1.pdf");
}

Imports IronPdf
Imports System.IO
Imports System.Drawing
' Example 1: From an Image File or Bytes

Shared Sub Main(ByVal args() As String)
	Dim renderer = New IronPdf.ChromePdfRenderer()

	Dim pngBinaryData = File.ReadAllBytes("embed_me.png")

	Dim ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(base64bytes)
	Dim ImgHtml = $"<img src='{ImgDataURI}'>"

	Dim pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml)
	pdfdoc.SaveAs("embeded_example_1.pdf")
End Sub

本程序将首先加载图像。在上述代码中，"ReadAllBytes "函数将图像转换为字节格式。 之后，图像数据将被编码为 base64，并以字符串的形式放入 HTML 标签中。 之后，HTML 字符串将通过使用RenderHtmlAsPdf "方法功能。 它将在 PDF 文档中创建一个 PDF 页面。

下一个示例将展示如何在 PDF 文档中使用位图图像。 IronPDF 有一种有益的方法，可将 System.Drawing.Image 嵌入 HTML 文档，然后将其渲染为 PDF。 请访问以下网站ImageUtilities API以了解更多相关信息。 下面的代码将展示它是如何工作的：

/* Example 2: From a System.Drawing.Bitmap */

//System.Drawing.BitMap MyImage

string DataURI =  IronPdf.Util.ImageToDataUri(MyImage);
var ImgHtml = $"<img src='{DataURI}'>";
using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);
pdfdoc2.SaveAs("emeded_example_2.pdf");

/* Example 2: From a System.Drawing.Bitmap */

//System.Drawing.BitMap MyImage

string DataURI =  IronPdf.Util.ImageToDataUri(MyImage);
var ImgHtml = $"<img src='{DataURI}'>";
using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);
pdfdoc2.SaveAs("emeded_example_2.pdf");

' Example 2: From a System.Drawing.Bitmap 

'System.Drawing.BitMap MyImage

Dim DataURI As String = IronPdf.Util.ImageToDataUri(MyImage)
Dim ImgHtml = $"<img src='{DataURI}'>"
Dim pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml)
pdfdoc2.SaveAs("emeded_example_2.pdf")

在上述代码中，使用 ImageToDataUri 函数将其转换为 URI，然后操作员使用 RenderHtmlAsPdf 函数将图像绘制为 PDF 文档。 这适用于多张图片。

此外，IronPDF 还能够在 PDF 中渲染图表, 在 PDF 文档中添加 BarCode, 使用密码增强 PDF 安全性和给 PDF 文件加水印甚至以编程方式处理 PDF 表单.

许可

IronPDF 是一款优秀的 PDF 库，可协助您创建和定制 PDF 文件，现在就可以购买。 不过，IronPDF 完全免费，可用于开发目的。 您还可以激活免费试用版用于生产，无任何付款细节。 购买 IronPDF 后，Iron Software 为您提供了一个绝佳的优惠，只需花两个软件包的价格即可购买五个 Iron Software 软件包。 是的! 您没有听错--您只需支付两套产品的价格，即可购买一套包含五种 Iron Software 产品的套件。 立即购买! 参观IronPDF 许可页面了解更多详情。