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

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

This article was translated from English: Does it need improvement?
Translated
View the article in English

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. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf
  2. Skopiuj i uruchom ten fragment kodu.

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. Wdroż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?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

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

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

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

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?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs
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");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")
$vbLabelText   $csharpLabel

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


Icon Quote related to 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 related to Jak wygląda plik PDF zawierający wiele obrazów?

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku
Icon Quote related to Jak wygląda plik PDF zawierający wiele obrazów?

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 related to Jak wygląda plik PDF zawierający wiele obrazów?

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku
Icon Quote related to Jak wygląda plik PDF zawierający wiele obrazów?

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 related to Jak wygląda plik PDF zawierający wiele obrazów?

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:

  • : Obraz umieszczony w lewym górnym rogu strony.
  • : Obraz umieszczony w prawym górnym rogu strony.
  • : Obraz wyśrodkowany na stronie.
  • : Obraz dopasowany do strony, zachowując jego oryginalne proporcje.
  • : Obraz umieszczony w lewym dolnym rogu strony.
  • : Obraz umieszczony w prawym dolnym rogu strony.
  • : Obraz dopasowany do strony.
  • : 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?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs
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");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

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

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

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
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?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs
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");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

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

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
$vbLabelText   $csharpLabel

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ę...

Czytaj więcej
Sprawdzone przez
Jeff Fritz
Jeffrey T. Fritz
Główny Menedżer Programu - Zespół .NET Community
Jeff jest również Głównym Menedżerem Programu dla zespołów .NET i Visual Studio. Jest producentem wykonawczym wirtualnej serii konferencji .NET Conf i prowadzi 'Fritz and Friends', transmisję na żywo dla deweloperów emitowaną dwa razy w tygodniu, gdzie rozmawia o technologii i pisze kod razem z widzami. Jeff pisze warsztaty, prezentacje i planuje treści dla największych wydarzeń Microsoft dla deweloperów, w tym Microsoft Build, Microsoft Ignite, .NET Conf i Microsoft MVP Summit.
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 19,936,792 | Wersja: 2026.7 właśnie wydany
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.