使用 C# 中的 Azure Blob 存储图像渲染 PDF

已更新:2026年1月10日

Translated

View the article in English

要在 C# 中使用 Azure Blob Storage 图像渲染 PDF，需要以二进制形式检索 Blob 数据，将其转换为 base64 字符串，嵌入 HTML img 标记中，然后使用 IronPDF 的 ChromePdfRenderer 将 HTML 转换为 PDF。

Azure Blob Storage 是由微软 Azure 提供的基于云的存储服务。它存储大量非结构化数据，如文本或二进制数据，可通过 HTTP 或 HTTPS 访问。在 C# 中处理 PDF 时，IronPDF 提供了强大的功能，可处理各种图像格式和来源，包括存储在 Azure Blob Storage 等云服务中的图像。

要使用存储在 Azure Blob Storage 中的图像，您必须处理二进制数据格式，而不是直接引用文件。解决方案是将图片转换为 base64 字符串并嵌入 img 标记中。这种方法可与IronPDF的HTML到PDF转换功能无缝配合，保持图像质量和格式。

快速入门：使用 Azure Blob 存储图像渲染 PDF

使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf
PM > Install-Package IronPdf

复制并运行这段代码。

var blobBase64 = Convert.ToBase64String(new BlobContainerClient("conn","cont").GetBlobClient("img.jpg").DownloadContent().Value.Content.ToArray());
new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf($"<img src=\"data:image/jpeg;base64,{blobBase64}\" />").SaveAs("blobImage.pdf");

部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronPDF

最小工作流程(5 个步骤)

下载 IronPDF 以渲染存储在 Azure Blob 中的图像。
处理检索 Blob 的过程
使用 `ToBase64String` 方法将字节转换为 base64
在 `img` 标记中包含 base64 信息
将 HTML 渲染成 PDF

如何将 Azure Blob 图像转换为 HTML？

使用包含 blobs 的容器设置 Azure 存储账户，然后在 C# 项目中处理身份验证和连接。与 IronPDF 一起使用 Azure.Storage.Blobs NuGet 包。对于复杂的身份验证场景，请探索 IronPDF 的 HTTP 请求标头功能，以实现安全的 blob 访问。

使用 DownloadToStreamAsync 方法将图像下载为流。将流数据转换为 Base64 并嵌入 HTML img 标记中。将 imageTag 变量合并到您的 HTML 文档中。这种技术非常适用于创建带有动态加载的云存储图像的报告或文档。

using Azure.Storage.Blobs;
using System;
using System.IO;
using System.Threading.Tasks;

public async Task ConvertBlobToHtmlAsync()
{
    // Define your connection string and container name
    string connectionString = "your_connection_string";
    string containerName = "your_container_name";

    // Initialize BlobServiceClient with the connection string
    BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);

    // Get the BlobContainerClient for the specified container
    BlobContainerClient blobContainer = blobServiceClient.GetBlobContainerClient(containerName);

    // Get the reference to the blob and initialize a stream
    BlobClient blobClient = blobContainer.GetBlobClient("867.jpg");
    using var stream = new MemoryStream();

    // Download the blob data to the stream
    await blobClient.DownloadToAsync(stream);
    stream.Position = 0; // Reset stream position

    // Convert the stream to a byte array
    byte[] array = stream.ToArray();

    // Convert bytes to base64
    var base64 = Convert.ToBase64String(array);

    // Create an img tag with the base64-encoded string
    var imageTag = $"<img src=\"data:image/jpeg;base64,{base64}\"/><br/>";

    // Use the imageTag in your HTML document as needed
}

using Azure.Storage.Blobs;
using System;
using System.IO;
using System.Threading.Tasks;

public async Task ConvertBlobToHtmlAsync()
{
    // Define your connection string and container name
    string connectionString = "your_connection_string";
    string containerName = "your_container_name";

    // Initialize BlobServiceClient with the connection string
    BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);

    // Get the BlobContainerClient for the specified container
    BlobContainerClient blobContainer = blobServiceClient.GetBlobContainerClient(containerName);

    // Get the reference to the blob and initialize a stream
    BlobClient blobClient = blobContainer.GetBlobClient("867.jpg");
    using var stream = new MemoryStream();

    // Download the blob data to the stream
    await blobClient.DownloadToAsync(stream);
    stream.Position = 0; // Reset stream position

    // Convert the stream to a byte array
    byte[] array = stream.ToArray();

    // Convert bytes to base64
    var base64 = Convert.ToBase64String(array);

    // Create an img tag with the base64-encoded string
    var imageTag = $"<img src=\"data:image/jpeg;base64,{base64}\"/><br/>";

    // Use the imageTag in your HTML document as needed
}

Imports Azure.Storage.Blobs
Imports System
Imports System.IO
Imports System.Threading.Tasks

Public Async Function ConvertBlobToHtmlAsync() As Task
	' Define your connection string and container name
	Dim connectionString As String = "your_connection_string"
	Dim containerName As String = "your_container_name"

	' Initialize BlobServiceClient with the connection string
	Dim blobServiceClient As New BlobServiceClient(connectionString)

	' Get the BlobContainerClient for the specified container
	Dim blobContainer As BlobContainerClient = blobServiceClient.GetBlobContainerClient(containerName)

	' Get the reference to the blob and initialize a stream
	Dim blobClient As BlobClient = blobContainer.GetBlobClient("867.jpg")
	Dim stream = New MemoryStream()

	' Download the blob data to the stream
	Await blobClient.DownloadToAsync(stream)
	stream.Position = 0 ' Reset stream position

	' Convert the stream to a byte array
	Dim array() As Byte = stream.ToArray()

	' Convert bytes to base64
	Dim base64 = Convert.ToBase64String(array)

	' Create an img tag with the base64-encoded string
	Dim imageTag = $"<img src=""data:image/jpeg;base64,{base64}""/><br/>"

	' Use the imageTag in your HTML document as needed
End Function

$vbLabelText $csharpLabel

在处理多张图片或不同格式的图片时，请利用 IronPDF 对各种图片类型的支持，包括 JPG、PNG、SVG 和 GIF。 base64 编码方法适用于所有这些格式。

使用不同的图像格式

Azure Blob Storage 支持各种图像格式，IronPDF 在正确编码后可处理所有这些格式。下面是一个可动态确定 MIME 类型的增强示例：

public string GetImageMimeType(string blobName)
{
    var extension = Path.GetExtension(blobName).ToLower();
    return extension switch
    {
        ".jpg" or ".jpeg" => "image/jpeg",
        ".png" => "image/png",
        ".gif" => "image/gif",
        ".svg" => "image/svg+xml",
        ".webp" => "image/webp",
        _ => "image/jpeg" // default fallback
    };
}

public async Task<string> CreateImageTagFromBlob(BlobClient blobClient)
{
    using var stream = new MemoryStream();
    await blobClient.DownloadToAsync(stream);
    stream.Position = 0;

    var base64 = Convert.ToBase64String(stream.ToArray());
    var mimeType = GetImageMimeType(blobClient.Name);

    return $"<img src=\"data:{mimeType};base64,{base64}\" alt=\"{Path.GetFileNameWithoutExtension(blobClient.Name)}\"/>";
}

public string GetImageMimeType(string blobName)
{
    var extension = Path.GetExtension(blobName).ToLower();
    return extension switch
    {
        ".jpg" or ".jpeg" => "image/jpeg",
        ".png" => "image/png",
        ".gif" => "image/gif",
        ".svg" => "image/svg+xml",
        ".webp" => "image/webp",
        _ => "image/jpeg" // default fallback
    };
}

public async Task<string> CreateImageTagFromBlob(BlobClient blobClient)
{
    using var stream = new MemoryStream();
    await blobClient.DownloadToAsync(stream);
    stream.Position = 0;

    var base64 = Convert.ToBase64String(stream.ToArray());
    var mimeType = GetImageMimeType(blobClient.Name);

    return $"<img src=\"data:{mimeType};base64,{base64}\" alt=\"{Path.GetFileNameWithoutExtension(blobClient.Name)}\"/>";
}

Imports System.IO
Imports System.Threading.Tasks

Public Function GetImageMimeType(blobName As String) As String
    Dim extension = Path.GetExtension(blobName).ToLower()
    Select Case extension
        Case ".jpg", ".jpeg"
            Return "image/jpeg"
        Case ".png"
            Return "image/png"
        Case ".gif"
            Return "image/gif"
        Case ".svg"
            Return "image/svg+xml"
        Case ".webp"
            Return "image/webp"
        Case Else
            Return "image/jpeg" ' default fallback
    End Select
End Function

Public Async Function CreateImageTagFromBlob(blobClient As BlobClient) As Task(Of String)
    Using stream As New MemoryStream()
        Await blobClient.DownloadToAsync(stream)
        stream.Position = 0

        Dim base64 = Convert.ToBase64String(stream.ToArray())
        Dim mimeType = GetImageMimeType(blobClient.Name)

        Return $"<img src=""data:{mimeType};base64,{base64}"" alt=""{Path.GetFileNameWithoutExtension(blobClient.Name)}""/>"
    End Using
End Function

$vbLabelText $csharpLabel

如何将 HTML 转换为 PDF？

使用ChromePdfRenderer的 RenderHtmlAsPdf 方法将 imageTag 转换为 PDF。 IronPDF 的 Chrome 渲染引擎可在转换过程中保持图像质量和定位。为获得最佳效果，请配置渲染选项以控制 PDF 输出质量。

以下是如何拨打RenderHtmlAsPdf：

:path=/static-assets/pdf/content-code-examples/how-to/images-azure-blob-storage-html-to-pdf.cs

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf(imageTag);

// Export to a file
pdf.SaveAs("imageToPdf.pdf");

Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Create a PDF from a HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf(imageTag)

' Export to a file
pdf.SaveAs("imageToPdf.pdf")

$vbLabelText $csharpLabel

调整 "htmlContent" 变量，以包含您的实际 HTML 内容，并包含 imageTag。

完整工作示例

下面是一个将 Azure Blob Storage 检索与 IronPDF 渲染相结合的综合示例，包括错误处理和优化：

using Azure.Storage.Blobs;
using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Threading.Tasks;

public class AzureBlobToPdfConverter
{
    private readonly string _connectionString;
    private readonly ChromePdfRenderer _renderer;

    public AzureBlobToPdfConverter(string connectionString)
    {
        _connectionString = connectionString;
        _renderer = new ChromePdfRenderer();

        // Configure rendering options for better image quality
        _renderer.RenderingOptions.ImageQuality = 100;
        _renderer.RenderingOptions.DpiResolution = 300;
    }

    public async Task<PdfDocument> ConvertBlobImagesToPdfAsync(string containerName, List<string> blobNames)
    {
        var htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<html><body style='margin: 20px;'>");

        var blobServiceClient = new BlobServiceClient(_connectionString);
        var containerClient = blobServiceClient.GetBlobContainerClient(containerName);

        foreach (var blobName in blobNames)
        {
            try
            {
                var blobClient = containerClient.GetBlobClient(blobName);
                var imageTag = await CreateImageTagFromBlob(blobClient);
                htmlBuilder.Append(imageTag);
                htmlBuilder.Append("<br/><br/>"); // Add spacing between images
            }
            catch (Exception ex)
            {
                // Log error and continue with other images
                Console.WriteLine($"Error processing blob {blobName}: {ex.Message}");
            }
        }

        htmlBuilder.Append("</body></html>");

        // Convert the complete HTML to PDF
        return _renderer.RenderHtmlAsPdf(htmlBuilder.ToString());
    }

    private async Task<string> CreateImageTagFromBlob(BlobClient blobClient)
    {
        using var stream = new MemoryStream();
        await blobClient.DownloadToAsync(stream);
        stream.Position = 0;

        var base64 = Convert.ToBase64String(stream.ToArray());
        var mimeType = GetImageMimeType(blobClient.Name);

        return $"<img src=\"data:{mimeType};base64,{base64}\" " +
               $"alt=\"{Path.GetFileNameWithoutExtension(blobClient.Name)}\" " +
               $"style=\"max-width: 100%; height: auto;\"/>";
    }

    private string GetImageMimeType(string blobName)
    {
        var extension = Path.GetExtension(blobName).ToLower();
        return extension switch
        {
            ".jpg" or ".jpeg" => "image/jpeg",
            ".png" => "image/png",
            ".gif" => "image/gif",
            ".svg" => "image/svg+xml",
            ".webp" => "image/webp",
            _ => "image/jpeg"
        };
    }
}

using Azure.Storage.Blobs;
using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Threading.Tasks;

public class AzureBlobToPdfConverter
{
    private readonly string _connectionString;
    private readonly ChromePdfRenderer _renderer;

    public AzureBlobToPdfConverter(string connectionString)
    {
        _connectionString = connectionString;
        _renderer = new ChromePdfRenderer();

        // Configure rendering options for better image quality
        _renderer.RenderingOptions.ImageQuality = 100;
        _renderer.RenderingOptions.DpiResolution = 300;
    }

    public async Task<PdfDocument> ConvertBlobImagesToPdfAsync(string containerName, List<string> blobNames)
    {
        var htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<html><body style='margin: 20px;'>");

        var blobServiceClient = new BlobServiceClient(_connectionString);
        var containerClient = blobServiceClient.GetBlobContainerClient(containerName);

        foreach (var blobName in blobNames)
        {
            try
            {
                var blobClient = containerClient.GetBlobClient(blobName);
                var imageTag = await CreateImageTagFromBlob(blobClient);
                htmlBuilder.Append(imageTag);
                htmlBuilder.Append("<br/><br/>"); // Add spacing between images
            }
            catch (Exception ex)
            {
                // Log error and continue with other images
                Console.WriteLine($"Error processing blob {blobName}: {ex.Message}");
            }
        }

        htmlBuilder.Append("</body></html>");

        // Convert the complete HTML to PDF
        return _renderer.RenderHtmlAsPdf(htmlBuilder.ToString());
    }

    private async Task<string> CreateImageTagFromBlob(BlobClient blobClient)
    {
        using var stream = new MemoryStream();
        await blobClient.DownloadToAsync(stream);
        stream.Position = 0;

        var base64 = Convert.ToBase64String(stream.ToArray());
        var mimeType = GetImageMimeType(blobClient.Name);

        return $"<img src=\"data:{mimeType};base64,{base64}\" " +
               $"alt=\"{Path.GetFileNameWithoutExtension(blobClient.Name)}\" " +
               $"style=\"max-width: 100%; height: auto;\"/>";
    }

    private string GetImageMimeType(string blobName)
    {
        var extension = Path.GetExtension(blobName).ToLower();
        return extension switch
        {
            ".jpg" or ".jpeg" => "image/jpeg",
            ".png" => "image/png",
            ".gif" => "image/gif",
            ".svg" => "image/svg+xml",
            ".webp" => "image/webp",
            _ => "image/jpeg"
        };
    }
}

Imports Azure.Storage.Blobs
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Text
Imports System.Threading.Tasks

Public Class AzureBlobToPdfConverter
    Private ReadOnly _connectionString As String
    Private ReadOnly _renderer As ChromePdfRenderer

    Public Sub New(connectionString As String)
        _connectionString = connectionString
        _renderer = New ChromePdfRenderer()

        ' Configure rendering options for better image quality
        _renderer.RenderingOptions.ImageQuality = 100
        _renderer.RenderingOptions.DpiResolution = 300
    End Sub

    Public Async Function ConvertBlobImagesToPdfAsync(containerName As String, blobNames As List(Of String)) As Task(Of PdfDocument)
        Dim htmlBuilder As New StringBuilder()
        htmlBuilder.Append("<html><body style='margin: 20px;'>")

        Dim blobServiceClient As New BlobServiceClient(_connectionString)
        Dim containerClient = blobServiceClient.GetBlobContainerClient(containerName)

        For Each blobName In blobNames
            Try
                Dim blobClient = containerClient.GetBlobClient(blobName)
                Dim imageTag = Await CreateImageTagFromBlob(blobClient)
                htmlBuilder.Append(imageTag)
                htmlBuilder.Append("<br/><br/>") ' Add spacing between images
            Catch ex As Exception
                ' Log error and continue with other images
                Console.WriteLine($"Error processing blob {blobName}: {ex.Message}")
            End Try
        Next

        htmlBuilder.Append("</body></html>")

        ' Convert the complete HTML to PDF
        Return _renderer.RenderHtmlAsPdf(htmlBuilder.ToString())
    End Function

    Private Async Function CreateImageTagFromBlob(blobClient As BlobClient) As Task(Of String)
        Using stream As New MemoryStream()
            Await blobClient.DownloadToAsync(stream)
            stream.Position = 0

            Dim base64 = Convert.ToBase64String(stream.ToArray())
            Dim mimeType = GetImageMimeType(blobClient.Name)

            Return $"<img src=""data:{mimeType};base64,{base64}"" " &
                   $"alt=""{Path.GetFileNameWithoutExtension(blobClient.Name)}"" " &
                   $"style=""max-width: 100%; height: auto;""/>"
        End Using
    End Function

    Private Function GetImageMimeType(blobName As String) As String
        Dim extension = Path.GetExtension(blobName).ToLower()
        Return extension Select Case extension
            Case ".jpg", ".jpeg"
                Return "image/jpeg"
            Case ".png"
                Return "image/png"
            Case ".gif"
                Return "image/gif"
            Case ".svg"
                Return "image/svg+xml"
            Case ".webp"
                Return "image/webp"
            Case Else
                Return "image/jpeg"
        End Select
    End Function
End Class

$vbLabelText $csharpLabel

性能考虑

在处理大型图像或多个 blob 时，实施 async 和多线程技术以提高性能。添加缓存机制，避免重复下载相同的 blob。

对于生产环境，尤其是 Azure 部署，请查看 IronPDF 的 Azure 部署指南，了解最佳实践和配置建议。对于内存密集型操作，请使用IronPDF的内存流功能来优化资源使用。

安全性和身份验证

访问 Azure Blob Storage 时确保正确的身份验证。为增强安全性，请在访问受保护资源时执行定制 HTTP 标头。考虑为包含 Azure blob 图像的敏感文档实施 PDF 密码保护。

常见问题的故障排除

如果遇到 blob 存储集成问题，请查阅 IronPDF 的 Azure 故障排除指南，了解常见问题的解决方案。对于图像的具体问题，图像呈现文档提供了处理各种情况的详细指导。

常见问题解答

如何使用存储在 Azure Blob Storage 中的图像生成 PDF？

要使用 Azure Blob Storage 图像生成 PDF，可以二进制形式检索 Blob 数据，将其转换为 base64 字符串，嵌入 HTML img 标签，然后使用 IronPDF 的 ChromePdfRenderer 将 HTML 转换为 PDF。这种方法可与 IronPDF 的 HTML 至 PDF 转换功能无缝配合，同时保持图像质量。

将 Azure Blob 图像渲染为 PDF 的最快方法是什么？

最快捷的方法是使用 IronPDF 的单行方法：使用 BlobContainerClient 获取 blob，使用 Convert.ToBase64String() 将其转换为 base64，将其嵌入 img 标签，然后使用 IronPDF 的 ChromePdfRenderer().RenderHtmlAsPdf() 方法进行渲染。

为什么不能在 PDF 文件中直接使用 Azure Blob Storage 图像的文件引用？

Azure Blob 存储需要处理二进制数据格式，而不是直接引用文件。解决方案是将图片转换为 base64 字符串并嵌入 img 标记中，然后 IronPDF 可以通过其 HTML 到 PDF 的转换功能进行处理。

在 PDF 中使用 Azure Blob 图像需要哪些 NuGet 软件包？

您需要使用 Azure.Storage.Blobs NuGet 包进行 blob 存储操作，同时使用 IronPDF 进行 PDF 渲染。IronPDF 提供 ChromePdfRenderer，用于将带有嵌入式 base64 图像的 HTML 转换为 PDF 文档。

生成 PDF 时，如何处理安全 Azure Blob 访问的身份验证？

在 C# 项目中使用正确的身份验证和连接设置 Azure Storage 帐户。对于复杂的身份验证场景，您可以探索 IronPDF 的 HTTP 请求头功能，以便在渲染 PDF 时处理安全 blob 访问。

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？

Nuget 下载 18,560,885 | 版本: 2026.4 刚刚发布

查看许可证

还在滚动吗？

想快速获得证据？ PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。

查看许可证

客户亮点：

开发者焦点：

网络研讨会：

立即开始30天免费试用

本页内容

使用 C# 中的 Azure Blob 存储图像渲染 PDF

使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

复制并运行这段代码。

部署到您的生产环境中进行测试

最小工作流程(5 个步骤)

如何将 Azure Blob 图像转换为 HTML？

使用不同的图像格式

如何将 HTML 转换为 PDF？

完整工作示例

性能考虑

安全性和身份验证

常见问题的故障排除

常见问题解答

如何使用存储在 Azure Blob Storage 中的图像生成 PDF？

将 Azure Blob 图像渲染为 PDF 的最快方法是什么？

为什么不能在 PDF 文件中直接使用 Azure Blob Storage 图像的文件引用？

在 PDF 中使用 Azure Blob 图像需要哪些 NuGet 软件包？

生成 PDF 时，如何处理安全 Azure Blob 访问的身份验证？

还在滚动吗？

钢铁支援团队

立即开始30天免费试用

本页内容

使用 C# 中的 Azure Blob 存储图像渲染 PDF

使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

复制并运行这段代码。

部署到您的生产环境中进行测试

最小工作流程(5 个步骤)

如何将 Azure Blob 图像转换为 HTML？

使用不同的图像格式

如何将 HTML 转换为 PDF？

完整工作示例

性能考虑

安全性和身份验证

常见问题的故障排除

常见问题解答

如何使用存储在 Azure Blob Storage 中的图像生成 PDF？

将 Azure Blob 图像渲染为 PDF 的最快方法是什么？

为什么不能在 PDF 文件中直接使用 Azure Blob Storage 图像的文件引用？

在 PDF 中使用 Azure Blob 图像需要哪些 NuGet 软件包？

生成 PDF 时，如何处理安全 Azure Blob 访问的身份验证？

还在滚动吗？

免费获取

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

深受全球数百万工程师信赖

钢铁支援团队