如何为 PDF 添加图像

查克尼特·宾

2023年十月11日

更新 2025年二月5日

Translated

View the article in English

将图像嵌入PDF文件意味着将图像直接放置在PDF文件中，确保它是自包含的，不依赖于外部资源。这使得PDF即使在没有互联网连接或外部文件的情况下也能无缝显示图像。

IronPDF 能够将 HTML 字符串、文件和网页 URL 渲染成 PDF。通过使用这种方法，可以将图像嵌入HTML中，然后转换成PDF文档。

开始使用IronPDF！

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：

如何在PDF中添加图像

下载 IronPDF C# 库
准备要嵌入的图像文件
使用img标签在HTML中嵌入图像
使用RenderHtmlAsPdf方法将HTML渲染为PDF
使用Base64编码嵌入图像

在PDF中嵌入图像示例

要在PDF中嵌入图像，您必须首先在HTML中使用 related to 在PDF中嵌入图像示例标签包含图像。然后，使用RenderHtmlAsPdf方法将HTML转换为PDF。如果您有现有的PDF，您可以使用图像加盖器或HTML加盖器教程将图像加盖到PDF文档上。

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private html As String = "<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export PDF
pdf.SaveAs("embedImage.pdf")

$vbLabelText $csharpLabel

将 Base64 示例嵌入

要在HTML中使用base64嵌入图像，您首先需要通过读取图像文件或通过网络请求接收获得图像的二进制数据。使用Microsoft .NET中的Convert.ToBase64String方法将二进制数据转换为base64。在HTML中构造图像标签时，在base64数据前使用"data:image/svg+xml;base64,"。您可能已经注意到，在base64数据之前已指定了图像类型。请访问MDN Web 文档关于图像格式以获取有关图像格式类型的更多信息。

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

Imports IronPdf
Imports System
Imports System.IO

Private renderer As New ChromePdfRenderer()

' Import image file binary data
Private binaryData() As Byte = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg")

' Convert the binary data to base 64
Private imgDataUri As String = Convert.ToBase64String(binaryData)

' Embed in HTML
Private html As String = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>"

' Convert HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("embedImageBase64.pdf")

$vbLabelText $csharpLabel

查克尼特·宾

立即与工程团队聊天

软件工程师

Chaknith 是开发者中的福尔摩斯。他第一次意识到自己可能在软件工程方面有前途，是在他出于乐趣做代码挑战的时候。他的重点是 IronXL 和 IronBarcode，但他为能帮助客户解决每一款产品的问题而感到自豪。Chaknith 利用他从直接与客户交谈中获得的知识，帮助进一步改进产品。他的轶事反馈不仅仅局限于 Jira 票据，还支持产品开发、文档编写和市场营销，从而提升客户的整体体验。当他不在办公室时，他可能会在学习机器学习、编程或徒步旅行。