Embed Images with DataURIs in C# & VB PDF Rendering

Curtis Chau

更新日期:8月 31, 2025

Translated

View the article in English

在處理 HTML 字串和文件時，通常不依賴於資產目錄是有用的。為了解決這個問題，我們使用資料URI方案。

資料URI方案是一種用於網頁開發的方法，可以將資料直接嵌入到 HTML 或 CSS 代碼中，從而消除對單獨文件的需求。資料URI允許圖像、文件、甚至字體直接以字串形式注入到 HTML 文檔中。

快速開始：在PDF中使用資料URI嵌入圖像

通過使用資料URI在 IronPDF 中嵌入圖像，輕鬆地將 HTML 內容轉換為 PDF 文件。這份快速指南幫助開發人員使用簡單、高效的代碼來呈現包含嵌入圖像的 PDF。使用 IronPDF，您可以在維持圖像完整性的同時無縫地將 HTML 轉換為 PDF。讓我們深入了解一個簡單的範例，示範如何使用最少代碼直接將圖像嵌入您的 PDF 文件中。

Install IronPDF with NuGet Package Manager

PM > Install-Package IronPdf

Copy and run this code snippet.

new IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("<img src='data:image/png;base64,...' />").SaveAs("output.pdf");

Deploy to test on your live environment

Start using IronPDF in your project today with a free trial

Free 30 day Trial

class="hsg-featured-snippet">

最小工作流程 (5 步)

從 NuGet 下載 IronPDF
使用 ReadAllBytes 方法讀取圖像位元組
使用 ToBase64String 方法將位元組轉換為 base64
將 base64 資訊包括在 img 標籤中
將 HTML 呈現為 PDF

基本圖像嵌入範例

以下範例顯示了如何將圖像呈現到不含資產文件的 HTML 文檔中：

:path=/static-assets/pdf/content-code-examples/how-to/datauris-image.cs

using IronPdf;
using System;

// Read byte from image file
var pngBinaryData = System.IO.File.ReadAllBytes("My_image.png");

// Convert bytes to base64
var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

// Import base64 to img tag
var ImgHtml = $"<img src='{ImgDataURI}'>";

ChromePdfRenderer Renderer = new ChromePdfRenderer();

// Render the HTML string
var pdf = Renderer.RenderHtmlAsPdf(ImgHtml);

pdf.SaveAs("datauri_example.pdf");

Imports IronPdf
Imports System

' Read byte from image file
Private pngBinaryData = System.IO.File.ReadAllBytes("My_image.png")

' Convert bytes to base64
Private ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

' Import base64 to img tag
Private ImgHtml = $"<img src='{ImgDataURI}'>"

Private Renderer As New ChromePdfRenderer()

' Render the HTML string
Private pdf = Renderer.RenderHtmlAsPdf(ImgHtml)

pdf.SaveAs("datauri_example.pdf")

$vbLabelText $csharpLabel

我們也可以通過 IronPDF 的 ASP.NET MVC 集成將整個 HTML 字串或 PDF 文件作為位元組數組服務。