IRONSOFTWAREHOME

Renderowanie PDF z obrazami w Azure Blob Storage w C#

Curtis Chau
Curtis Chau
Updated: 24 kwietnia 2026

Aby renderować PDF-y za pomocą obrazów z Azure Blob Storage w C#, pobierz dane blob jako binarne, przekształć je w ciąg base64, osadź w znaczniku HTML img i użyj ChromePdfRenderer IronPDF do konwersji HTML na PDF.

Azure Blob Storage to usługa przechowywania danych w chmurze oferowana przez Microsoft Azure. Przechowuje duże ilości nieustrukturyzowanych danych, takich jak tekst lub dane binarne, dostępne za pośrednictwem HTTP lub HTTPS. Pracując z PDF w C#, IronPDF oferuje potężne możliwości obsługi różnych formatów obrazów i źródeł, w tym tych przechowywanych w usługach chmurowych, takich jak Azure Blob Storage.

Aby używać obrazów przechowywanych w Azure Blob Storage, trzeba obsłużyć format danych binarnych zamiast bezpośrednich odniesień do plików. Rozwiązaniem jest konwersja obrazów na ciągi base64 i osadzenie ich w znacznikach img. To podejście działa bezproblemowo z funkcjonalnością konwersji HTML na PDF IronPDF, zachowując jakość i formatowanie obrazów.

Quickstart: Renderowanie PDF z obrazami w Azure Blob Storage
  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Skopiuj i uruchom ten fragment kodu.

    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");
    C#
  3. 3Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
    arrow pointer

Jak przekonwertować obrazy z Azure Blob na HTML?

Skonfiguruj konto Azure Storage z kontenerem zawierającym blob, a następnie obsłuż uwierzytelnianie i połączenie w swoim projekcie C#. Użyj pakietu Azure.Storage.Blobs NuGet razem z IronPDF. Dla złożonych scenariuszy uwierzytelniania, eksploruj możliwości nagłówka żądania HTTP IronPDF dla zabezpieczonego dostępu do bloba.

Użyj metody DownloadAsync do pobierania obrazów jako strumienie. Przekształć dane ze strumienia na Base64 i osadź je w znacznikach HTML img. Połącz zmienną htmlContent z dokumentem HTML. Ta technika działa dobrze do tworzenia raportów lub dokumentów z dynamicznie ładowanymi obrazami z magazynu w chmurze.

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
}

Pracując z wieloma obrazami lub różnymi formatami, korzystaj z wsparcia IronPDF dla różnych typów obrazów w tym JPG, PNG, SVG i GIF. Metoda kodowania base64 działa uniwersalnie dla wszystkich tych formatów.

Praca z różnymi formatami obrazów

Azure Blob Storage obsługuje różne formaty obrazów, a IronPDF radzi sobie z nimi wszystkimi, gdy są odpowiednio zakodowane. Oto ulepszony przykład, który dynamicznie określa typ 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)}\"/>";
}

Jak przekonwertować HTML na PDF?

Konwertuj htmlContent na PDF przy użyciu metody RenderHtmlAsPdf() z ChromePdfRenderer. Silnik renderowania Chrome firmy IronPDF zachowuje jakość i pozycjonowanie obrazów podczas konwersji. Dla optymalnych wyników, skonfiguruj opcje renderowania do kontrolowania jakości wyjściowej PDF.

Oto jak wywołać SaveAs():

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");

Dostosuj zmienną pdfOptions, aby zawierała rzeczywistą zawartość HTML z bodyHtml.

Kompletny działający przykład

Oto kompleksowy przykład łączący pobieranie z Azure Blob Storage z renderowaniem IronPDF, w tym obsługa błędów i optymalizacja:

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"
        };
    }
}

Rozważania dotyczące wydajności

Pracując z dużymi obrazami lub wieloma blobami, zastosuj techniki asynchroniczne i wielowątkowe, aby poprawić wydajność. Dodaj mechanizmy pamięci podręcznej, aby uniknąć wielokrotnego pobierania tych samych blobów.

Dla środowisk produkcyjnych, zwłaszcza wdrożeń Azure, przejrzyj przewodnik wdrażania Azure firmy IronPDF dla najlepszych praktyk i zaleceń dotyczących konfiguracji. Dla operacji intensywnie wykorzystujących pamięć, używaj możliwości strumienia pamięci IronPDF do optymalizacji wykorzystania zasobów.

Bezpieczeństwo i uwierzytelnianie

Zapewnij właściwe uwierzytelnianie podczas uzyskiwania dostępu do Azure Blob Storage. Dla podwyższonego bezpieczeństwa, implementuj niestandardowe nagłówki HTTP podczas uzyskiwania dostępu do zasobów chronionych. Rozważ wdrożenie ochrony hasłem PDF dla poufnych dokumentów zawierających obrazy z Azure blob.

Rozwiązywanie typowych problemów

Jeśli napotkasz problemy z integracją magazynu blob, zapoznaj się z przewodnikiem rozwiązywania problemów Azure IronPDF w celu uzyskania rozwiązań typowych problemów. Dla problemów związanych z obrazami, dokumentacja renderowania obrazów zapewnia szczegółowe wskazówki dotyczące obsługi różnych scenariuszy.

DownloadToStreamAsync imageTag imageTag RenderHtmlAsPdf RenderHtmlAsPdf "htmlContent" imageTag

Często Zadawane Pytania

Jak wygenerowac PDF z obrazami przechowywanymi w Azure Blob Storage?

Aby wygenerowac PDF z obrazami w Azure Blob Storage, pobierz dane blob jako binarne, skonwertuj je na ciag base64, osadz w znaczniku img w HTML i uzyj ChromePdfRenderer z IronPDF do konwersji HTML na PDF. To podejscie dziala bezproblemowo z funkcjami konwersji HTML na PDF IronPDF, zachowujac jakosc obrazów.

Jaki jest najszybszy sposób na renderowanie obrazu Azure Blob do PDF?

Najszybsza metoda to uzycie IronPDF z podejsciem w jednym wierszu: pobierz blob uzywajac BlobContainerClient, skonwertuj na base64 przy pomocy Convert.ToBase64String(), osadz w znaczniku img i renderuj z metodą ChromePdfRenderer().RenderHtmlAsPdf() od IronPDF.

Dlaczego nie moge uzyc bezposrednich odniesien do plików dla obrazów z Azure Blob Storage w PDF?

Azure Blob Storage wymaga obslugi formatu danych binarnych zamiast bezposrednich odniesien do plików. Rozwiazaniem jest konwersja obrazów na ciagi base64 i osadzanie ich w znacznikach img, które IronPDF moze przetworzyc poprzez funkcje konwersji HTML na PDF.

Jakich paczek NuGet potrzebuje do pracy z obrazami blob w Azure w PDF?

Potrzebujesz paczki NuGet Azure.Storage.Blobs do operacji na przechowalniach blob oraz IronPDF do renderowania PDF. IronPDF dostarcza ChromePdfRenderer do konwersji HTML z osadzonymi obrazami base64 na dokumenty PDF.

Jak obsługiwać uwierzytelnianie w przypadku zabezpieczonego dostepu do Azure Blob podczas generowania PDF?

Skonfiguruj konto Azure Storage z odpowiednim uwierzytelnianiem i polaczeniem w twoim projekcie C#. W przypadkach zlozonych scenariuszy uwierzytelniania mozesz wykorzystac mozliwosci IronPDF dotyczace naglowków zadania HTTP do obslugi zabezpieczonego dostepu do blob podczas renderowania PDF.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543Wersja:2026.7właśnie wydany

Odbierz swój BEZPŁATNY

30-dniowy klucz próbny natychmiast.

bullet_checkedNie wymaga karty kredytowej ani tworzenia konta
test_punktorówTestuj w produkcji
bez znaków wodnych
kalendarz_punktorów30 dni w pełni
funkcjonalny produkt
wsparcie_punktorów24/5 wsparcie techniczne
w trakcie okresu próbnego
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka C# NuGet dla plików PDF
Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
  2. Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
  3. Wybierz pakiet i zainstaluj
DLL PDF dla C#
Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

  1. Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
  2. W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta