1. IronPDF
  2. Guides pratiques
  3. Images (jpg, png, svg, gif, etc)
Comment ajouter des images aux PDF en C#

Comment ajouter des images aux PDF en C# ; avec IronPdf

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF permet d'intégrer des images directement dans les PDF en convertissant les HTML contenant des balises d'image en documents PDF, créant ainsi des fichiers autonomes qui affichent des images sans dépendances externes ni connexions internet.

en-tête-2(Démarrage rapide : Intégrer des images dans des PDF facilement)

Commencez à intégrer des images dans des fichiers PDF à l'aide d'IronPDF for .NET C#. Convertissez votre image en chaîne Base64 et intégrez-la dans une balise HTML <img> pour générer un PDF autonome ne nécessitant aucun fichier externe. Cette méthode permet de s'assurer que les images s'affichent sans accès à l'internet.

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.

    new IronPdf.ChromePdfRenderer()
     .RenderHtmlAsPdf("<img src='data:image/png;base64," + Convert.ToBase64String(File.ReadAllBytes("logo.png")) + "'>")
     .SaveAs("image-embedded.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

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque IronPDF C#
  2. Préparez le fichier image à intégrer
  3. Utiliser la balise img pour intégrer des images dans le code HTML
  4. Transformez le HTML en PDF à l'aide de la méthode RenderHtmlAsPdf
  5. Intégrez l'image en utilisant l'encodage Base64


Comment incorporer des images dans des PDF?

<TODO : Ajouter une image ici -->

Pour intégrer une image dans un PDF, il faut d'abord inclure l'image dans le code HTML à l'aide de la balise <img>. Utilisez ensuite la méthode RenderHtmlAsPdf pour convertir le HTML en PDF. Si vous disposez d'un PDF existant, apposez l'image sur le document PDF à l'aide d'un image stamper ou d'un tutoriel HTML stamper. Cette approche fonctionne avec le moteur de rendu Chrome d'IronPDF.

Pourquoi la méthode RenderHtmlAsPdf est-elle la plus efficace ?

La méthode RenderHtmlAsPdf exploite le moteur de rendu Chrome d'IronPDF pour convertir le contenu HTML, y compris les images, au format PDF tout en préservant la mise en page et le style. Cette méthode prend en charge les mises en page CSS réactives et garantit le rendu des images telles qu'elles apparaissent dans un navigateur web. Pour les mises en page complexes, consultez notre guide sur la mise en forme HTML parfaite au pixel près.

Quels sont les formats d'image pris en charge ?

IronPDF prend en charge tous les principaux formats d'image, notamment PNG, JPG, SVG, GIF et BMP lors de l'intégration par le biais de la conversion HTML. La bibliothèque gère efficacement les graphiques SVG pour les illustrations vectorielles évolutives. Lorsque vous travaillez avec différents formats, assurez-vous que votre HTML spécifie correctement le type d'image dans l'attribut src ou dans l'URI de données Base64.

Quand utiliser l'URL directe ou le codage Base64?

Utilisez des URL directes lorsque les images sont hébergées en ligne et que la taille du fichier pose problème. Choisissez l'encodage Base64 pour les PDF autonomes qui ne nécessitent pas d'accès à Internet. Pour les images stockées dans des services cloud, consultez notre guide sur l'intégration d'images à partir d'Azure Blob Storage. Cette décision a un impact sur la taille des fichiers et la portabilité des PDF générés.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");
$vbLabelText   $csharpLabel

<TODO : Ajouter une image ici -->

Comment intégrer des images en utilisant Base64?

Pour utiliser Base64 afin d'incorporer une image dans HTML, il faut d'abord obtenir les données binaires de l'image en lisant le fichier image ou en le recevant par le biais d'une requête réseau. Utilisez la méthode Convert.ToBase64String dans .NET pour convertir les données binaires en Base64. Construisez la balise image en HTML en utilisant "data:image/svg+xml;base64," avant les données Base64. Notez que le type d'image est spécifié avant les données Base64. Visitez les MDN Web Docs sur les formats d'image pour plus d'informations sur les types de formats d'image.

Pourquoi utiliser le codage Base64 pour les images?

L'encodage Base64 crée des PDF autonomes qui ne dépendent pas de ressources externes, ce qui garantit que les images s'affichent toujours sans connectivité internet ou lorsque les fichiers d'image originaux sont déplacés ou supprimés. Cette technique est utile pour créer des PDF dans des applications Blazor Server ou pour déployer vers Azure où l'accès aux fichiers externes pourrait être restreint. Les images encodées deviennent partie intégrante de la chaîne HTML, ce qui les rend idéales pour les conversions chaîne HTML vers PDF.

Quelles sont les considérations en matière de performances ?

L'encodage Base64 augmente la taille des fichiers d'environ 33 % mais élimine les dépendances externes, ce qui le rend idéal pour l'archivage ou les environnements réseau restreints. Lorsque les performances sont essentielles, pensez à utiliser async PDF generation pour gérer plusieurs conversions d'images simultanément. Pour les opérations à grande échelle, consultez notre guide d'optimisation des performances pour maximiser le débit.

Comment traiter les fichiers d'images volumineux ?

<TODO : Ajouter une image ici -->

Pour les images de grande taille, compressez-les avant l'encodage Base64 afin de réduire la taille du fichier PDF, ou utilisez des URL externes si la taille du fichier est critique. IronPDF offre des fonctions de compression de PDF qui peuvent réduire la taille des fichiers jusqu'à 75 %. Lorsque vous travaillez avec plusieurs images, optimisez vos paramètres de rendu pour obtenir le meilleur équilibre entre la qualité et la taille du fichier.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs
using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");
$vbLabelText   $csharpLabel

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de didacticiels ici : Fonctionnalités supplémentaires

Questions Fréquemment Posées

Comment ajouter des images à des documents PDF en C# ?

Avec IronPDF, vous pouvez ajouter des images aux PDF en les incluant dans le code HTML à l'aide de la balise related to Comment ajouter des images à des documents PDF en C# ?, puis en convertissant le code HTML en PDF à l'aide de la méthode RenderHtmlAsPdf. Cette approche tire parti du moteur de rendu Chrome d'IronPDF pour un rendu précis des images dans vos documents PDF.

Quels formats d'image puis-je intégrer dans les PDF ?

IronPDF prend en charge tous les principaux formats d'image, notamment PNG, JPG, SVG, GIF et BMP, lors de l'intégration par conversion HTML. La bibliothèque gère particulièrement bien les graphiques SVG pour les illustrations vectorielles extensibles, ce qui garantit un rendu correct de vos images dans le PDF généré.

Dois-je utiliser des URL directes ou le codage Base64 pour les images ?

Utilisez des URL directes lorsque les images sont hébergées en ligne et que la taille du fichier est un problème. Choisissez l'encodage Base64 avec IronPDF lorsque vous créez des PDF autonomes qui ne nécessitent pas d'accès à internet. L'encodage Base64 garantit que vos PDF affichent les images sans dépendances externes.

Puis-je ajouter des images à des fichiers PDF existants ?

Oui, IronPDF vous permet d'ajouter des images à des PDF existants à l'aide d'un stamper d'image ou d'un stamper HTML. Cette fonction vous permet de superposer des images sur des pages ou des positions spécifiques dans vos documents PDF existants.

Comment convertir une image en Base64 pour l'intégrer dans un PDF ?

Convertissez votre image en chaîne Base64 et intégrez-la directement dans une balise HTML related to Comment convertir une image en Base64 pour l'intégrer dans un PDF ? à l'aide d'un URI de données. La méthode RenderHtmlAsPdf d'IronPDF traitera ensuite cette image encodée en Base64 et l'incorporera dans votre PDF, créant ainsi un document autonome.

L'intégration d'images préserve-t-elle les styles et les mises en page CSS ?

Oui, le moteur de rendu Chrome d'IronPDF préserve les mises en page et le style CSS lors de la conversion de HTML avec des images en PDF. La bibliothèque prend en charge les mises en page CSS réactives, ce qui garantit que les images s'affichent exactement comme elles le feraient dans un navigateur web.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
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