Jak dodawać obrazy do plików PDF w języku C# za pomocą IronPDF

Curtis Chau

Updated: 22 kwietnia 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

IronPDF umożliwia osadzanie obrazów bezpośrednio w plikach PDF poprzez konwersję kodu HTML zawierającego tagi obrazów do dokumentów PDF, tworząc samodzielne pliki, które wyświetlają obrazy bez zewnętrznych zależności lub połączeń internetowych.

Rozpocznij wbudowywanie obrazów w plikach PDF używając IronPDF w .NET C#. Przekształć swój obraz w ciąg Base64 i osadź go w tagu HTML <img>, aby wygenerować samodzielny PDF, który nie wymaga zewnętrznych plików. Ta metoda gwarantuje wyświetlanie obrazów bez dostępu do Internetu.

Jak osadzić obrazy w plikach PDF?

Aby osadzić obraz w PDF, najpierw włącz obraz do HTML korzystając z tagu <img>. Następnie użyj metody RenderHtmlAsPdf, aby przekonwertować HTML na PDF. Jeśli masz istniejący PDF, opieczętuj obraz na dokumencie PDF, używając tutorialu dla pieczętarki obrazów lub HTML. To podejście działa z silnikiem renderującym IronPDF dla przeglądarki Chrome.

Dlaczego metoda RenderHtmlAsPdf działa najlepiej?

Metoda RenderHtmlAsPdf wykorzystuje silnik renderowania Chrome z IronPDF do konwersji treści HTML, w tym obrazów, na format PDF, zachowując układ i stylizację. Ta metoda obsługuje responsywne układy CSS i zapewnia, że obrazy są renderowane tak, jak wyglądają w przeglądarce internetowej. W przypadku złożonych układów graficznych zapoznaj się z naszym przewodnikiem dotyczącym formatowania HTML z zachowaniem idealnej dokładności pikselowej.

Jakie formaty obrazów są obsługiwane?

IronPDF obsługuje wszystkie główne formaty obrazów, w tym PNG, JPG, SVG, GIF i BMP, podczas osadzania poprzez konwersję HTML. Biblioteka skutecznie obsługuje grafikę SVG, umożliwiając tworzenie skalowalnych ilustracji wektorowych. Pracując z różnymi formatami, upewnij się, że HTML prawidłowo określa typ obrazu w atrybucie src lub w danych URI Base64.

Kiedy należy używać bezpośredniego adresu URL, a kiedy kodowania Base64?

W przypadku obrazów hostowanych online, gdy rozmiar pliku ma znaczenie, należy używać bezpośrednich adresów URL. Wybierz kodowanie Base64 dla samodzielnych plików PDF, które nie wymagają dostępu do Internetu. W przypadku obrazów przechowywanych w usługach chmurowych zapoznaj się z naszym przewodnikiem dotyczącym osadzania obrazów z usługi Azure Blob Storage. Decyzja ta ma wpływ zarówno na rozmiar pliku, jak i na przenośność wygenerowanych plików PDF.

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

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

Dim renderer As New ChromePdfRenderer()

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

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

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

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

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

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

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

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak osadzić obrazy przy użyciu Base64?

Aby użyć Base64 do osadzenia obrazu w HTML, najpierw pozyskaj dane binarne obrazu, czytając plik obrazowy lub odbierając je przez żądanie sieciowe. Użyj metody Convert.ToBase64String w .NET, aby przekonwertować dane binarne na Base64. Skonstruuj znacznik obrazu w HTML za pomocą "data:image/svg+xml;base64," przed danymi Base64. Należy pamiętać, że typ obrazu jest określony przed danymi Base64. Więcej informacji na temat typów formatów obrazów można znaleźć w dokumentacji MDN Web Docs poświęconej formatom obrazów.

Dlaczego warto stosować kodowanie Base64 w przypadku obrazów?

Kodowanie Base64 tworzy samodzielne pliki PDF, które nie są zależne od zasobów zewnętrznych, zapewniając wyświetlanie obrazów nawet bez połączenia z Internetem lub w przypadku przeniesienia lub usunięcia oryginalnych plików graficznych. Technika ta jest przydatna podczas tworzenia plików PDF w aplikacjach Blazor Server lub podczas wdrażania w Azure, gdzie dostęp do plików zewnętrznych może być ograniczony. Zakodowane obrazy stają się częścią ciągu HTML, co sprawia, że idealnie nadają się do konwersji ciągów HTML do formatu PDF.

Jakie są kwestie związane z wydajnością?

Kodowanie Base64 zwiększa rozmiar pliku o około 33%, ale eliminuje zależności zewnętrzne, dzięki czemu idealnie nadaje się do celów archiwizacji lub w środowiskach sieciowych o ograniczonym dostępie. Gdy wydajność ma kluczowe znaczenie, warto rozważyć wykorzystanie asynchronicznego generowania plików PDF w celu jednoczesnej obsługi wielu konwersji obrazów. W przypadku operacji na dużą skalę zapoznaj się z naszym przewodnikiem po optymalizacji wydajności, aby zmaksymalizować przepustowość.

Jak radzić sobie z dużymi plikami graficznymi?

W przypadku dużych obrazów należy je skompresować przed kodowaniem Base64, aby zminimalizować rozmiar pliku PDF, lub użyć zewnętrznych adresów URL, jeśli rozmiar pliku ma kluczowe znaczenie. IronPDF oferuje funkcje kompresji plików PDF, które pozwalają zmniejszyć rozmiar plików nawet o 75%. W przypadku pracy z wieloma obrazami należy zoptymalizować ustawienia renderowania, aby uzyskać najlepszy kompromis między jakością a rozmiarem pliku.

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

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

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

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Zapoznaj się z naszą stroną z samouczkami tutaj: Dodatkowe funkcje

Curtis Chau

Czat z zespołem inżynierów teraz

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