Konwertuj JPEG na PDF .NET | Tutorial C# IronPDF

Jak zainstalować IronPDF do konwersji plików JPEG na PDF?

Przed napisaniem jakiegokolwiek kodu konwersji dodaj IronPDF do swojego projektu .NET. Biblioteka jest dystrybuowana za pośrednictwem NuGet i instaluje się w kilka sekund.

Otwórz konsolę menedżera pakietów w Visual Studio i uruchom:

Install-Package IronPdf

Install-Package IronPdf

Lub użyj interfejsu CLI platformy .NET:

dotnet add package IronPdf

dotnet add package IronPdf

IronPDF obsługuje platformy .NET 8, .NET 9 i .NET 10, a także .NET Framework 4.6.2 i nowsze wersje. Nie są wymagane żadne dodatkowe zależności środowiskowe — pakiet zawiera wszystko, co jest potrzebne do konwersji obrazów do formatu PDF w systemach Windows, Linux, macOS, Docker i Azure.

Po zainstalowaniu dodaj pojedynczą instrukcję using IronPdf; na początku pliku i możesz rozpocząć konwersję.

Pakiet IronPDF NuGet zawiera silnik renderujący, więc nie ma osobnego instalatora dla serwerów produkcyjnych. W przypadku wdrożeń w chmurze zapoznaj się z instrukcją konfiguracji Docker, aby skonfigurować odpowiedni obraz bazowy.

Jak przekonwertować pojedynczy obraz JPEG do formatu PDF w języku C#?

Najprostszym sposobem konwersji plików JPEG do formatu PDF jest użycie metody statycznej ImageToPdfConverter.ImageToPdf(). Przekaż ścieżkę do pliku obrazu, odbierz obiekt PdfDocument i zapisz go w dowolnym miejscu.

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

Imports IronPdf

' Convert a single JPG image to PDF
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Save the converted PDF file
pdf.SaveAs("converted-photo.pdf")

Metoda ImageToPdf przyjmuje ścieżkę do pliku JPEG i zwraca obiekt PdfDocument, który można zapisać, przesyłać strumieniowo lub przekazać do innych operacji IronPDF. Konwersja odbywa się w pamięci, co sprawia, że jest to idealne rozwiązanie dla aplikacji internetowych, które muszą obsługiwać pliki PDF bezpośrednio, bez korzystania z dysku.

Wynikowy plik PDF zachowuje oryginalną jakość obrazu, a jednocześnie jest zapakowany w format, który może otworzyć każdy czytnik PDF. Rozmiar strony jest obsługiwany automatycznie — domyślnie wymiary strony PDF odpowiadają wymiarom obrazu, co zapewnia czysty wynik bez białych obramowań, chyba że zostaną one zamówione. Jeśli potrzebujesz określonych marginesów, skorzystaj z interfejsu API niestandardowych marginesów.

Dla programistów zaznajomionych już z konwersją HTML do PDF, API konwersji obrazów działa według tego samego schematu: podaj dane wejściowe, skonfiguruj opcje w razie potrzeby i zapisz wynik.

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

Imports IronPdf

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Get the PDF as a byte array for streaming
Dim pdfBytes As Byte() = pdf.BinaryData

' In an ASP.NET Core controller:
' Return File(pdfBytes, "application/pdf", "converted.pdf")

Jak przekonwertować wiele plików JPEG na jeden dokument PDF?

Konwersja zbiorcza — połączenie kilku obrazów JPEG w jeden plik PDF — jest równie prosta. Przekaż listę ścieżek do plików do ImageToPdfConverter.ImageToPdf(), a biblioteka umieści każdy obraz na osobnej stronie w wynikach.

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

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

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

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

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

Imports IronPdf
Imports System.IO
Imports System.Linq

' Gather all JPG files from a folder
Dim imagePaths = Directory.EnumerateFiles("photos") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) _
             OrElse f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase))

' Convert multiple JPEG images to a single PDF file
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Save the combined PDF
pdf.SaveAs("photo-collection.pdf")

Obrazy pojawiają się w pliku PDF w tej samej kolejności, w jakiej występują w pliku enumerable. Aby kontrolować kolejność stron, posortuj ścieżki plików przed przekazaniem ich do konwertera — na przykład według nazwy pliku, daty utworzenia lub dowolnego niestandardowego porządku, który pasuje do Twojego przepływu pracy.

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

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

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

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

Imports IronPdf
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

Dim imagePaths = Directory.EnumerateFiles("photos") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase))

Dim pdfDocuments As New List(Of PdfDocument)()

For Each imagePath In imagePaths
    Dim individualPdf = ImageToPdfConverter.ImageToPdf( _
        imagePath, _
        ImageBehavior.FitToPageAndMaintainAspectRatio _
    )
    pdfDocuments.Add(individualPdf)
Next

' Merge all individual PDFs into one document
Dim combinedPdf As PdfDocument = PdfDocument.Merge(pdfDocuments)
combinedPdf.SaveAs("custom-photo-collection.pdf")

Jakie formaty obrazów obsługuje ten konwerter PDF?

Konwerter obrazów na PDF firmy IronPDF obsługuje szeroki zakres formatów, nie tylko JPEG. Ta sama klasa ImageToPdfConverter przetwarza pliki PNG, BMP, GIF, TIFF, SVG i WebP przy użyciu identycznych wywołań metod — nie są potrzebne oddzielne ścieżki kodu dla różnych typów obrazów.

W przypadku plików TIFF IronPDF obsługuje konwersję wielo-ramkowego formatu TIFF do PDF, gdzie każda ramka w pliku TIFF staje się oddzielną stroną w wyjściowym pliku PDF. Jest to szczególnie przydatne w przypadku zeskanowanych dokumentów wielostronicowych, które są dostarczane w postaci archiwów TIFF.

Oprócz statycznych obrazów rastrowych IronPDF przetwarza również grafikę wektorową SVG w pełnej rozdzielczości, co czyni go niezawodnym narzędziem do konwersji diagramów technicznych i ikon bez utraty jakości. Ten sam silnik, który obsługuje obrazy, renderuje również HTML do formatu PDF, dzięki czemu dobrze obsługiwane są potoki treści mieszanych — dokumenty zawierające zarówno obrazy, jak i tekst sformatowany w HTML.

W przeciwieństwie do przeglądarkowych lub internetowych konwerterów PDF, IronPDF działa całkowicie w ramach procesu .NET. Pliki nigdy nie opuszczają serwera, co ma znaczenie w przypadku aplikacji obsługujących poufne dokumenty, obrazy medyczne lub dokumentację finansową.

Jak kontrolować rozmieszczenie obrazów w przekonwertowanym pliku PDF?

Domyślnie IronPDF dopasowuje rozmiar strony PDF do wymiarów obrazu. Jeśli potrzebujesz innego zachowania — dopasowania obrazów do standardowego rozmiaru papieru, wyśrodkowania ich z białymi marginesami lub przycięcia w celu wypełnienia strony — użyj wyliczenia ImageBehavior w połączeniu z ImageToPdfRenderOptions.

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

Imports IronPdf

Dim renderingOptions As New ImageToPdfRenderOptions With {
    .ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    .PaperSize = PdfPaperSize.A4,
    .MarginTop = 25,
    .MarginBottom = 25,
    .MarginLeft = 25,
    .MarginRight = 25
}

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions)
pdf.SaveAs("formatted-output.pdf")

Dostępne wartości ImageBehavior obejmują najczęstsze wymagania dotyczące układu:

• FitToPageAndMaintainAspectRatio -- skaluje obraz tak, aby wypełnił stronę, zachowując proporcje
• CenteredOnPage -- umieszcza obraz w oryginalnym rozmiarze, wyśrodkowany poziomo i pionowo
• TopLeftCornerOfPage -- umieszcza obraz w lewym górnym rogu bez skalowania
• CropPage -- przycina rozmiar strony, aby dokładnie dopasować go do wymiarów obrazu

Po konwersji można zastosować dodatkowe przekształcenia. Dodaj znak wodny za pomocą znaczników HTML, dołącz nagłówki i stopki w celu identyfikacji dokumentu lub obróć strony, aby dopasować je do żądanej orientacji.

Dodatkowe opcje przetwarzania końcowego obejmują:

• Stemplowanie tekstu lub obrazów w celu umieszczenia znaków firmowych lub znaków zatwierdzenia
• Stosowanie szablonów tła w celu uzyskania efektu papieru firmowego
• Kompresja wyjściowego pliku PDF w celu zmniejszenia rozmiaru pliku do wysłania pocztą elektroniczną lub przesłania
• Rysowanie kształtów i adnotacji do oznaczania wizualnego

Jakie są najczęstsze zastosowania konwersji plików JPEG do formatu PDF?

Programowa konwersja plików JPEG do formatu PDF stanowi podstawę wielu procesów związanych z dokumentami. Zrozumienie najczęstszych scenariuszy pomaga zaprojektować odpowiednią architekturę aplikacji.

Archiwizacja dokumentów i zgodność z przepisami — organizacje skanujące dokumenty papierowe tworzą pliki JPEG za pomocą skanerów płaskich i dokumentówych. Konwersja tych plików do formatu PDF umożliwia indeksowanie, długoterminowe przechowywanie w formacie PDF/A oraz dostęp za pośrednictwem standardowych platform zarządzania dokumentami. PDF/A to standard ISO zaprojektowany specjalnie do archiwizacji, a IronPDF obsługuje generowanie plików zgodnych z tym standardem.

Generowanie raportów i pulpitów nawigacyjnych — aplikacje generujące wykresy, zrzuty ekranu lub wizualizacje danych często zapisują wyniki w formacie JPEG. Osadzenie ich w raportach PDF za pomocą ImageToPdfConverter pozwala uzyskać spójne, gotowe do druku dokumenty, które interesariusze mogą przeglądać bez konieczności instalowania oprogramowania do tworzenia wykresów.

Portfolio zdjęć i galerie — specjaliści z branży kreatywnej oraz platformy nieruchomościowe wykorzystują zbiorczą konwersję plików JPEG do formatu PDF w celu tworzenia arkuszy nieruchomości do druku, albumów portfolio oraz katalogów w formacie PDF. Połączenie kilkudziesięciu zdjęć w jeden plik PDF z zakładkami, po którym można się poruszać, zapewnia lepszą prezentację niż folder z plikami graficznymi.

Zautomatyzowane procesy przesyłania — aplikacje internetowe, które akceptują pliki JPEG przesyłane przez użytkowników — zdjęcia profilowe, dokumenty uzupełniające, skany dokumentów tożsamości — mogą normalizować wszystkie przesłane pliki do formatu PDF w celu zapewnienia spójnego przetwarzania na dalszych etapach. Ułatwia to przechowywanie, wyszukiwanie i renderowanie, ponieważ aplikacja obsługuje jeden format zamiast wielu.

Według badań branżowych przeprowadzonych przez PDF Association format PDF pozostaje najczęściej używanym formatem dokumentów w środowiskach Enterprise, dlatego konwersja obrazów do formatu PDF na wczesnym etapie procesu pracy przynosi korzyści w zakresie kompatybilności i długoterminowej dostępności.

Sieć Mozilla Developer Network dokumentuje typ MIME plików PDF jako application/pdf, który jest natywnie obsługiwany przez wszystkie główne przeglądarki bez wtyczek — co sprawia, że PDF jest najbezpieczniejszym formatem dla dokumentów, które muszą być wyświetlane w przeglądarce.

Aby zwiększyć bezpieczeństwo w każdym z tych scenariuszy, IronPDF obsługuje redagowanie plików PDF w celu trwałego usunięcia poufnych treści, czyszczenie plików PDF w celu usunięcia ukrytych metadanych oraz podpisy cyfrowe do uwierzytelniania dokumentów.

Jak dodać nagłówki, stopki i metadane do przekonwertowanych plików PDF?

Przekonwertowany plik JPEG do formatu PDF to często tylko punkt wyjścia. Aplikacje produkcyjne zazwyczaj wymagają dodania metadanych dokumentu, numerów stron i oznaczeń firmowych przed dostarczeniem ostatecznego pliku.

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

Imports IronPdf
Imports IronPdf.Editing

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Add a text footer with page numbers
Dim footer As New TextHeaderFooter With {
    .CenterText = "Page {page} of {total-pages}",
    .DrawDividerLine = True,
    .FontSize = 10
}
pdf.AddTextFooters(footer)

' Set document metadata
pdf.MetaData.Title = "Converted Photo Document"
pdf.MetaData.Author = "Document Processing System"
pdf.MetaData.CreationDate = System.DateTime.Now

' Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
)

pdf.SaveAs("final-document.pdf")

W przypadku konwersji zbiorczych przed zapisaniem można zastosować ten sam stopkę i metadane do każdej strony w pliku PDF zawierającym wiele obrazów. Asynchroniczny interfejs API umożliwia środowiskom o dużej przepustowości przetwarzanie wielu obrazów jednocześnie bez blokowania wątków.

Jeśli wdrożenie odbywa się w chmurze, zapoznaj się z przewodnikiem wdrożeniowym platformy Azure oraz dokumentacją konfiguracyjną AWS, aby uzyskać informacje dotyczące konfiguracji specyficznej dla danego środowiska. Niestandardowy interfejs API rejestrowania integruje się z Serilog, NLog i Microsoft.Rozszerzenia.Logging w celu monitorowania operacyjnego.

Przewodnik rozwiązywania problemów IronPDF obejmuje najczęstsze problemy pojawiające się w środowisku produkcyjnym, w tym ładowanie czcionek, błędy uprawnień w systemie Linux oraz różnice w renderowaniu w różnych wersjach .NET.

Jakie są Twoje kolejne kroki?

Klasa ImageToPdfConverter firmy IronPDF zapewnia prostą ścieżkę od plików JPEG do profesjonalnych dokumentów PDF w języku C#. API obsługuje pojedyncze obrazy i kolekcje zbiorcze za pomocą tego samego wywołania metody, obsługuje siedem formatów obrazów bez dodatkowego kodu i integruje się z pełnym zakresem funkcji IronPDF do manipulacji plikami PDF.

Zacznij od zainstalowania pakietu za pośrednictwem NuGet:

Install-Package IronPdf

Install-Package IronPdf

Następnie dostosuj przykłady kodu z tego samouczka do swojego przypadku użycia. Konwersja pojedynczego obrazu wymaga zaledwie trzech linii kodu. Przetwarzanie wsadowe wymaga zapytania LINQ i jednego wywołania metody. Dostosowanie układu wykorzystuje klasę ImageToPdfRenderOptions z wyliczeniem ImageBehavior.

Bezpłatna wersja próbna IronPDF zapewnia pełny dostęp do wszystkich funkcji w celu ich oceny. Gdy będziesz gotowy do wdrożenia, zapoznaj się z opcjami licencyjnymi dla zastosowań komercyjnych, w tym ścieżkami aktualizacji licencji dla rozwijających się zespołów. Strona funkcji konwertera PDF IronPDF zawiera listę wszystkich obsługiwanych typów konwersji, jeśli potrzebujesz obsługiwać więcej niż tylko pliki wejściowe w formacie JPEG.

W przypadku powiązanych procesów przekształcania obrazów w dokumenty, przewodnik dodawania obrazów do plików PDF obejmuje osadzanie obrazów na istniejących stronach PDF, a samouczek HTML do PDF wyjaśnia, jak generować pliki PDF z szablonów HTML, które łączą tekst i obrazy w jednym dokumencie.