IRONSOFTWAREHOME

Jak konwertować obrazy do formatu PDF w języku C#

Curtis Chau
Curtis Chau
Updated: 3 czerwca 2026

IronPDF umożliwia programistom C# konwersję pojedynczych lub wielu obrazów (JPG, PNG, TIFF) w dokumenty PDF przy użyciu metody ImageToPdfConverter.ImageToPdf z dostosowalnymi zachowaniami umieszczania i opcjami renderowania.

Konwersja obrazów do formatu PDF polega na połączeniu wielu plików graficznych (takich jak JPG, PNG lub TIFF) w jeden dokument PDF. Proces ten pozwala tworzyć cyfrowe portfolio, prezentacje lub raporty, ułatwiając udostępnianie i przechowywanie zbiorów obrazów w uporządkowanym i powszechnie czytelnym formacie.

IronPDF konwertuje pojedyncze lub wiele obrazów na pliki PDF z unikalnym rozmieszczeniem i zachowaniem obrazów. Te zachowania obejmują dopasowanie do strony, wyśrodkowanie na stronie oraz przycięcie strony. Dodatkowo można dodawać nagłówki i stopki tekstowe oraz HTML za pomocą IronPDF, nakładać znaki wodne za pomocą IronPDF, ustawiać niestandardowe rozmiary stron oraz dodawać nakładki w tle i na pierwszym planie.

Szybki start: Konwersja obrazów do formatu PDF za pomocą IronPDF

Konwertuj obrazy na dokumenty PDF przy użyciu klasy ImageToPdfConverter IronPDF. Ten przykład pokazuje, jak przekształcić plik graficzny w plik PDF, co pozwala na zintegrowanie funkcji konwersji obrazu do formatu PDF z aplikacjami .NET C#. Przy minimalnym nakładzie kodu można konwertować obrazy do formatu PDF w celu tworzenia cyfrowych portfolio lub raportów.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Skopiuj i uruchom ten fragment kodu.

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.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ć pojedynczy obraz do formatu PDF?

Użyj statycznej metody ImageToPdf w klasie ImageToPdfConverter, aby przekonwertować obraz na dokument PDF. Ta metoda wymaga jedynie podania ścieżki do obrazu i konwertuje go na dokument PDF z domyślnym rozmieszczeniem i zachowaniem obrazu. Obsługiwane formaty obrazów to .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp i .pjpeg.

Przed rozpoczęciem upewnij się, że zainstalowałeś IronPDF za pośrednictwem NuGet lub pobrałeś instalator dla systemu Windows. Biblioteka działa płynnie na platformach Windows, macOS i Linux, dzięki czemu jest wszechstronna w różnych środowiskach programistycznych.

Jakie formaty obrazów są obsługiwane?

Członkowie zespołu Iron Software w fioletowych uniformach na wydarzeniu firmowym

IronPDF obsługuje szeroki zakres formatów obrazów, w tym formaty rastrowe, takie jak JPEG, PNG, BMP i GIF, a także formaty wektorowe, takie jak grafika SVG. Biblioteka obsługuje zarówno standardowe, jak i nowoczesne formaty, takie jak WebP i AVIF, zapewniając kompatybilność ze współczesnymi aplikacjami internetowymi. W przypadku specjalistycznych potrzeb należy pracować z plikami ikon (.ico) i plikami kursorów (.cur).

Jak napisać kod?

using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

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

W bardziej zaawansowanych scenariuszach warto rozważyć asynchroniczne generowanie plików PDF w celu poprawy wydajności podczas przetwarzania wielu obrazów. Biblioteka obsługuje również niestandardowe rozmiary papieru i marginesy, aby zapewnić wyświetlanie obrazów dokładnie zgodnie z wymaganiami.

Jak wygląda wynik?


Jak przekonwertować wiele obrazów do formatu PDF?

Aby przekonwertować wiele obrazów do dokumentu PDF, dostarcz obiekt IEnumerable zawierający ścieżki plików zamiast pojedynczej ścieżki pliku. Powoduje to wygenerowanie dokumentu PDF z domyślnym rozmieszczeniem obrazów i zachowaniem.

W przypadku pracy z wieloma obrazami warto rozważyć dostępne opcje kompresji plików PDF, aby zoptymalizować rozmiar pliku bez utraty jakości. Jest to szczególnie ważne podczas tworzenia dużych portfolio lub albumów ze zdjęciami.

Jak przetwarzać wiele obrazów jednocześnie?

using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

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

Jak wygląda plik PDF zawierający wiele obrazów?


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 mogę kontrolować rozmieszczenie i zachowanie obrazów?

IronPDF oferuje różne opcje umieszczania obrazów i zachowania. Możesz wyśrodkować obraz na stronie lub dopasować go do rozmiaru strony, zachowując jego proporcje. Wszystkie dostępne pozycje i zachowania obrazów to:

  • TopLeftCornerOfPage: Obraz umieszczony w lewym górnym rogu strony.
  • TopRightCornerOfPage: Obraz umieszczony w prawym górnym rogu strony.
  • CenteredOnPage: Obraz wyśrodkowany na stronie.
  • FitToPageAndMaintainAspectRatio: Obraz dopasowany do strony, zachowując jego oryginalne proporcje.
  • BottomLeftCornerOfPage: Obraz umieszczony w lewym dolnym rogu strony.
  • BottomRightCornerOfPage: Obraz umieszczony w prawym dolnym rogu strony.
  • FitToPage: Obraz dopasowany do strony.
  • CropPage: Strona dostosowana do dopasowania obrazu.

Te opcje rozmieszczenia płynnie współpracują z funkcjami orientacji i obracania stron w IronPDF, umożliwiając tworzenie profesjonalnie wyglądających dokumentów niezależnie od wymiarów obrazu.

Jak zastosować zachowania obrazów w kodzie?

using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

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

Jakie są wizualne różnice między zachowaniami obrazów?

Członkowie zespołu Iron Software w fioletowej odzieży sportowej z logo firmy podczas imprezy firmowej
Członkowie zespołu Iron Software w fioletowej odzieży sportowej z logo firmy podczas imprezy firmowej na świeżym powietrzu
Członkowie zespołu Iron Software w fioletowej odzieży sportowej z logo firmy podczas imprezy firmowej
Członkowie zespołu Iron Software w fioletowych uniformach na wydarzeniu sportowym firmy
Członkowie zespołu Iron Software w fioletowych strojach sportowych podczas firmowej imprezy sportowej z napisem "Poznaj nasz zespół"
Członkowie zespołu Iron Software w fioletowej odzieży sportowej z logo firmy podczas firmowej imprezy sportowej z nałożonym tekstem z logo
Członkowie zespołu Iron Software w fioletowych uniformach na wydarzeniu zespołowym firmy z tekstem 'Poznaj nasz zespół' na nakładce
Członkowie zespołu Iron Software w fioletowej odzieży sportowej z logo firmy podczas imprezy firmowej

Jak dostosować opcje renderowania plików PDF?

Statyczna metoda ImageToPdf konwertuje obrazy, importując je jako znaczniki HTML <img>, a następnie konwertując HTML na PDF. Pozwala to na przekazanie obiektu ChromePdfRenderOptions jako trzeciego parametru do dostosowania procesu renderowania bezpośrednio.

Takie podejście zapewnia dostęp do wszystkich zaawansowanych opcji renderowania dostępnych w IronPDF, w tym wykonywania kodu JavaScript, typów mediów CSS oraz konfiguracji okna wyświetlania. Możesz nawet wykorzystać czcionki internetowe i ikony, aby poprawić atrakcyjność wizualną dokumentu.

Jak dodać nagłówki i niestandardowe style?

using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

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

Jeśli masz bardziej złożone wymagania dotyczące nagłówków i stopek, zapoznaj się z naszym obszernym przewodnikiem po nagłówkach i stopkach HTML. Możesz również dodać numery stron do plików PDF opartych na obrazach, aby zapewnić lepszą organizację.

Jak wygląda dostosowany wynik?

Jak radzić sobie z wydajnością i dużymi zbiorami obrazów?

W przypadku pracy z dużymi zbiorami obrazów lub obrazami o wysokiej rozdzielczości należy zastosować techniki asynchroniczne i wielowątkowe w celu poprawy wydajności. W przypadku aplikacji Enterprise warto zapoznać się ze strategiami optymalizacji wydajności IronPDF, aby zapewnić płynne działanie nawet przy znacznym obciążeniu.

Dodatkowo, podczas pracy z obrazami przechowywanymi w usługach chmurowych, zapoznaj się z naszym przewodnikiem dotyczącym osadzania obrazów z Azure Blob Storage, aby zapewnić płynną integrację z chmurą.

Jak przekonwertować pliki PDF z powrotem na obrazy?

Aby przekonwertować lub zrasteryzowac dokument PDF na obrazy, zapoznaj sie z naszym przewodnikiem dotyczącym rasteryzacji PDF do obrazów.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Konwersja PDF-ów

Często Zadawane Pytania

Jakie formaty obrazów mozna skonwertowac do PDF?

IronPDF obsługuje szeroka game formatów obrazów do konwersji na PDF, w tym .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp oraz .pjpeg. Obejmuje to zarówno formaty rastrowe, takie jak JPEG, PNG, BMP i GIF, jak i formaty wektorowe jak grafika SVG.

Jak skonwertowac pojedynczy obraz na PDF w C#?

Aby skonwertowac pojedynczy obraz na PDF przy uzyciu IronPDF, uzyl metody statycznej ImageToPdf w klasie ImageToPdfConverter. Podaj po prostu sciezke do pliku z obrazem: IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf"). To rozwiazanie z jednym wierszem kodu konwertuje twój obraz na dokument PDF z domyslnym umiejscowieniem i zachowaniem.

Czy moge skonwertowac wiele obrazów do jednego dokumentu PDF?

Tak, IronPDF umożliwia konwersje wielu obrazów (JPG, PNG, TIFF) do jednego dokumentu PDF przy uzyciu metody ImageToPdfConverter.ImageToPdf. Jest to idealne do tworzenia cyfrowych portfolio, prezentacji lub raportów, gdzie trzeba polaczyc kilka plików obrazów w jeden zorganizowany, powszechnie czytelny format PDF.

Jakie opcje dostosowywania sa dostepne podczas konwersji obrazów na PDF?

IronPDF oferuje rozbudowane opcje dostosowywania, w tym unikalne rozmieszczenia i zachowania obrazów (dopasowanie do strony, centrowanie, przycinanie), dodawanie tekstowych i HTML-owych naglowków i stopek, nakladanie znaków wodnych, ustawienie niestandardowych rozmiarów stron oraz tlo i nakladki w warstwach przednich i tylnych. Te funkcje umożliwiaja tworzenie profesjonalnych dokumentów PDF z twoich obrazów.

Które platformy obsluguja funkcje konwersji obrazów na PDF?

Konwersja obrazów na PDF dziala bezproblemowo na platformach Windows, macOS i Linux, co czyni ja uniwersalna dla róznych srodowisk deweloperskich. Mozesz ja zainstalować za posrednictwem NuGet lub pobrac instalator Windows, aby rozpoczac prace na preferowanej platformie.

Jak moge kontrolowac rozmieszczenie obrazów podczas konwersji na PDF?

IronPDF oferuje unikalne rozmieszczenia i zachowania obrazów, w tym dopasowanie do strony, centrowanie na stronie oraz przycinanie strony. Te zachowania eksportu obrazów daja ci dokladna kontrole nad tym, jak twoje obrazy beda wygladaly w koncowym dokumencie PDF, zapewniajac profesjonalne przedstawienie twojej zawartosci wizualnej.

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