Comment convertir des images en PDF en utilisant C#

Comment convertir des images en PDF en C#35;

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

IronPDF permet aux développeurs C# de convertir une ou plusieurs images (JPG, PNG, TIFF) en documents PDF à l'aide de la méthode ImageToPdfConverter.ImageToPdf avec des comportements de placement et des options de rendu personnalisables.

La conversion d'images au format PDF permet de combiner plusieurs fichiers images (tels que JPG, PNG ou TIFF) en un seul document PDF. Ce processus permet de créer des portfolios, des présentations ou des rapports numériques, facilitant ainsi le partage et le stockage de collections d'images dans un format organisé et lisible par tous.

IronPDF convertit des images uniques ou multiples en PDF avec des placements et comportements d'images uniques. Ces comportements incluent l'adaptation à la page, le centrage sur la page et le rognage de la page. De plus, vous pouvez ajouter des en-têtes et des pieds de page en texte et HTML à l'aide d'IronPDF, appliquer des filigranes avec IronPDF, définir des tailles de page personnalisées, et inclure des superpositions d'arrière-plan et de premier plan.

Démarrage rapide : Convertir des images en PDF avec IronPDF

Convertissez des images en documents PDF à l'aide de la classe ImageToPdfConverter d'IronPDF. Cet exemple montre comment transformer un fichier image en PDF, ce qui vous permet d'intégrer la fonctionnalité de conversion d'images en PDF dans vos applications .NET C#. Avec un minimum de code, vous pouvez convertir des images en PDF pour créer des portfolios ou des rapports numériques.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer


Comment convertir une seule image en PDF?

Utilisez la méthode statique ImageToPdf de la classe ImageToPdfConverter pour convertir une image en document PDF. Cette méthode ne requiert que le chemin d'accès à l'image et la convertit en document PDF avec l'emplacement et le comportement par défaut de l'image. Les formats d'image pris en charge incluent .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp, et .pjpeg.

Avant de commencer, assurez-vous d'avoir installé IronPDF via NuGet ou téléchargé le Windows installer. La bibliothèque fonctionne de manière transparente sur les plateformes Windows, macOS, et Linux, ce qui la rend polyvalente pour divers environnements de développement.

Quels sont les formats d'image pris en charge ?

Membres de l'équipe IronSoftware en uniforme violet lors d'un événement d'entreprise

IronPDF prend en charge une gamme complète de formats d'image, notamment les formats matriciels tels que JPEG, PNG, BMP et GIF, ainsi que les formats vectoriels tels que SVG graphics. La bibliothèque prend en charge les formats standard et modernes tels que WebP et AVIF, ce qui garantit la compatibilité avec les applications web contemporaines. Pour les besoins spécialisés, travaillez avec des fichiers d'icônes (.ico) et des fichiers de curseurs (.cur).

Comment écrire le code?

: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");
$vbLabelText   $csharpLabel

Pour des scénarios plus avancés, explorez la génération asynchrone de PDF pour améliorer les performances lors du traitement de plusieurs images. La bibliothèque prend également en charge les formats de papier personnalisés et les marges personnalisées pour garantir que vos images s'affichent exactement comme vous le souhaitez.

À quoi ressemble le résultat ?


Comment convertir plusieurs images en PDF?

Pour convertir plusieurs images en un document PDF, fournissez un objet IEnumerable contenant des chemins d'accès aux fichiers au lieu d'un seul chemin d'accès aux fichiers. Cette traduction génère un document PDF avec un placement et un comportement d'image par défaut.

Lorsque vous travaillez avec plusieurs images, pensez aux options de compression PDF disponibles pour optimiser la taille des fichiers sans sacrifier la qualité. Ceci est particulièrement important lors de la création de grands portfolios ou d'albums photos.

Comment traiter plusieurs images à la fois ?

: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");
$vbLabelText   $csharpLabel

À quoi ressemble le PDF multi-image?


Comment puis-je contrôler le placement et le comportement des images ?

IronPDF offre diverses options de placement et de comportement des images. Vous pouvez centrer l'image sur la page ou l'adapter à la taille de la page tout en conservant son rapport d'aspect. Tous les placements d'images et les comportements disponibles sont :

  • TopLeftCornerOfPage: L'image est placée dans le coin supérieur gauche de la page.
  • TopRightCornerOfPage: L'image est placée dans le coin supérieur droit de la page.
  • CenteredOnPage: L'image est centrée sur la page.
  • FitToPageAndMaintainAspectRatio:L'image s'adapte à la page tout en conservant son rapport d'aspect original.
  • BottomLeftCornerOfPage: L'image est placée dans le coin inférieur gauche de la page.
  • BottomRightCornerOfPage: L'image est placée dans le coin inférieur droit de la page.
  • FitToPage:L'image s'adapte à la page.
  • CropPage: La page est ajustée à l'image.

Ces options de placement fonctionnent de manière transparente avec les fonctionnalités orientation et rotation des pages d'IronPDF, ce qui vous permet de créer des documents d'aspect professionnel quelles que soient les dimensions de vos images.

Comment appliquer des comportements d'image dans le code?

: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");
$vbLabelText   $csharpLabel

Quelles sont les différences visuelles entre les comportements des images ?

Membres de l'équipe d'Iron Software en tenue de sport de marque violette lors d'un événement d'équipe de l'entreprise
Membres de l'équipe d'Iron Software en tenue de sport de marque violette lors d'un événement en plein air organisé par l'entreprise
Membres de l'équipe d'Iron Software en tenue de sport de marque violette lors d'un événement d'équipe de l'entreprise
Membres de l'équipe d'IronSoftware en uniforme violet lors d'un événement sportif de l'entreprise
Membres de l'équipe d'Iron Software en tenue de sport violette lors d'un événement sportif de l'entreprise avec la mention
Membres de l'équipe Iron Software en tenue de sport violette lors d'un événement sportif de l'entreprise, avec texte de la marque en surimpression
Membres de l'équipe d'IronSoftware en uniformes violets lors d'un événement d'entreprise avec le texte
Membres de l'équipe d'Iron Software en tenue de sport de marque violette lors d'un événement d'équipe d'entreprise

Comment personnaliser les options de rendu des PDF?

La méthode statique ImageToPdf convertit les images en les important sous forme de balises HTML <img>, puis en convertissant le HTML en PDF. Cela vous permet de passer l'objet ChromePdfRenderOptions en tant que troisième paramètre pour personnaliser directement le processus de rendu.

Cette approche permet d'accéder à toutes les puissantes options de rendu disponibles dans IronPdf, notamment l'exécution JavaScript, les types de médias CSS et la configuration du viewport. Vous pouvez même incorporer des polices et icônes web pour améliorer l'attrait visuel de votre document.

Comment ajouter des en-têtes et un style personnalisé?

: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");
$vbLabelText   $csharpLabel

Pour des exigences plus complexes en matière d'en-tête et de pied de page, consultez notre guide complet sur les en-têtes et pieds de page HTML . Vous pouvez également ajouter des numéros de page à vos PDF basés sur des images pour une meilleure organisation.

À quoi ressemble la sortie personnalisée ?

Comment gérer les performances et les grandes collections d'images?

Lorsque vous traitez de grandes collections d'images ou des images haute résolution, mettez en œuvre des techniques async et multithreading pour améliorer les performances. Pour les applications d'entreprise, explorez les stratégies d'optimisation des performances d'IronPDF afin de garantir un fonctionnement fluide, même avec des charges de travail importantes.

En outre, lorsque vous travaillez avec des images stockées dans des services en nuage, consultez notre guide sur l'intégration d'images à partir d'Azure Blob Storage pour une intégration transparente dans le nuage.

Comment reconvertir des PDF en images?

Pour convertir ou tramer un document PDF en images, consultez notre guide sur la façon de tramer des PDF en images.

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de tutoriels ici : Convertir les PDFs

Questions Fréquemment Posées

Quels formats d'image peuvent être convertis en PDF ?

IronPDF prend en charge une gamme complète de formats d'image pour la conversion PDF, notamment .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp et .pjpeg. Il s'agit de formats matriciels tels que JPEG, PNG, BMP et GIF, ainsi que de formats vectoriels tels que les graphiques SVG.

Comment convertir une seule image en PDF en C# ?

Pour convertir une seule image en PDF à l'aide d'IronPDF, utilisez la méthode statique ImageToPdf dans la classe ImageToPdfConverter. Il vous suffit d'indiquer le chemin d'accès à votre image : IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf"). Cette solution en une ligne convertit votre image en un document PDF avec un placement et un comportement par défaut.

Puis-je convertir plusieurs images en un seul document PDF ?

Oui, IronPDF vous permet de convertir plusieurs images (JPG, PNG, TIFF) en un seul document PDF à l'aide de la méthode ImageToPdfConverter.ImageToPdf. Cette méthode est parfaite pour créer des portfolios numériques, des présentations ou des rapports pour lesquels vous devez combiner plusieurs fichiers d'images en un format PDF organisé et lisible par tous.

Quelles sont les options de personnalisation disponibles lors de la conversion d'images en PDF ?

IronPDF offre des options de personnalisation étendues, notamment des placements et des comportements d'images uniques (ajustement à la page, centrage, recadrage), l'ajout de texte et d'en-têtes et pieds de page HTML, l'application de filigranes, la définition de tailles de page personnalisées et l'inclusion de superpositions d'arrière-plan et d'avant-plan. Ces fonctionnalités vous permettent de créer des documents PDF de qualité professionnelle à partir de vos images.

Quelles sont les plateformes prises en charge par la fonction de conversion d'images en PDF ?

La conversion d'images en PDF d'IronPdf fonctionne de manière transparente sur les plateformes Windows, macOS et Linux, ce qui la rend polyvalente pour divers environnements de développement. Vous pouvez l'installer via NuGet ou télécharger le programme d'installation Windows pour commencer sur votre plateforme préférée.

Comment puis-je contrôler l'emplacement des images lors de la conversion en PDF ?

IronPDF propose des placements et des comportements d'image uniques, notamment l'ajustement à la page, le centrage sur la page et le recadrage de la page. Ces comportements d'exportation d'images vous donnent un contrôle précis sur la façon dont vos images apparaissent dans le document PDF final, garantissant une présentation professionnelle de votre contenu visuel.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Revu par
Jeff Fritz
Jeffrey T. Fritz
Responsable principal du programme - Équipe de la communauté .NET
Jeff est également responsable principal du programme pour les équipes .NET et Visual Studio. Il est le producteur exécutif de la série de conférences virtuelles .NET Conf et anime 'Fritz and Friends', une diffusion en direct pour développeurs qui est diffusée deux fois par semaine où il parle de technologie et écrit du code avec les téléspectateurs. Jeff écrit des ateliers, des présentations et prévoit du contenu pour les plus grands événements de développement Microsoft, y compris Microsoft Build, Microsoft Ignite, .NET Conf et le sommet Microsoft MVP
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir