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) na dokumenty PDF przy użyciu metody ImageToPdfConverter.ImageToPdf z możliwością dostosowania zachowań umieszczania i opcji 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 za pomocą klasy ImageToPdfConverter biblioteki 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 metody statycznej w klasie, 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 podczas imprezy firmowej

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 tak, jak tego potrzebujesz.

Jak wygląda wynik?


Jak przekonwertować wiele obrazów do formatu PDF?

Aby przekonwertować wiele obrazów do dokumentu PDF, należy podać obiekt `` zawierający ścieżki do plików zamiast pojedynczej ścieżki. 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?


Jak mogę kontrolować rozmieszczenie obrazów i ich zachowanie?

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 jest w lewym górnym rogu strony.
  • : Obraz umieszczony jest w prawym górnym rogu strony.
  • : Obraz jest wyśrodkowany na stronie.
  • : Obraz dopasowuje się do strony, zachowując swoje oryginalne proporcje.
  • : Obraz umieszczony jest w lewym dolnym rogu strony.
  • : Obraz umieszczony jest w prawym dolnym rogu strony.
  • : Obraz dopasowuje się do strony.
  • : Strona jest dopasowywana do rozmiaru 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 strojach podczas firmowej imprezy sportowej
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 napisem z logo
Członkowie zespołu Iron Software w fioletowych uniformach podczas firmowej imprezy integracyjnej z napisem
Członkowie zespołu Iron Software w fioletowej odzieży sportowej z logo firmy podczas firmowej imprezy integracyjnej

Jak dostosować opcje renderowania plików PDF?

Metoda statyczna konwertuje obrazy, importując je jako HTML, a następnie konwertując HTML na PDF. Pozwala to na przekazanie obiektu `` jako trzeciego parametru w celu bezpośredniego dostosowania procesu renderowania.

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 zrasteryzować dokument PDF na obrazy, zapoznaj się z naszym przewodnikiem dotyczącym rasteryzacji plików PDF na obrazy.

Chcesz zobaczyć, co jeszcze możesz zrobić? Zapoznaj się z naszą stroną z samouczkami tutaj: Konwersja plików PDF

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 18,926,724 | Wersja: 2026.5 just released
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.