Créez des PDF en C# avec une seule ligne de code grâce à la bibliothèque .NET d'IronPDF, qui simplifie la génération de PDF à partir de chaînes HTML, d'URL ou de formulaires grâce à des fonctionnalités de rendu intégrées et une intégration facile avec Visual Studio.
Créer un PDF dans une bibliothèque C# .NET est facile et efficace avec les bons guides. Avec IronPDF, vous pouvez créer et modifier facilement les fonctionnalités PDF en fonction des besoins de votre application. Cet exemple de didacticiel montre comment utiliser le logiciel de manière efficace dans votre projet et créer un PDF en un seul clic !
Les deux principales manières d'accéder à la bibliothèque sont :
Pour les débutants qui apprennent la génération de PDF .NET , le gestionnaire de packages NuGet offre la méthode d'installation la plus simple. Il gère automatiquement les dépendances et vous assure d'utiliser la dernière version stable. La présentation de l'installation fournit des instructions détaillées pour différents environnements de développement.
NuGet est l'approche recommandée pour la plupart des développeurs, en particulier ceux qui débutent dans le développement .NET . Il s'intègre parfaitement à Visual Studio et à d'autres IDE, ce qui le rend idéal pour la création de PDF en C# . Le Package Manager gère automatiquement toute la configuration complexe, notamment :
Lors de l'installation IronPDF, les développeurs rencontrent parfois quelques difficultés communes. Le guide de dépannage couvre la plupart des scénarios, mais voici les plus fréquents :
Environnement d'exécution Visual C++ manquant : IronPDF nécessite les composants redistribuables Visual C++. Si vous voyez des erreurs concernant des DLL manquantes, installez la dernière version de l'environnement d'exécution Visual C++ de Microsoft.
Blocage de NuGet par le pare-feu : Les environnements d'entreprise peuvent bloquer NuGet. Dans ce cas, vous pouvez télécharger le package hors ligne et l'installer manuellement.
Incompatibilités de plateforme : Assurez-vous que votre projet cible la plateforme appropriée (x86, x64 ou AnyCPU). IronPDF fonctionne mieux avec un ciblage de plateforme spécifique plutôt qu'avec AnyCPU.
Pour les développeurs qui apprennent la conversion HTML vers PDF , NuGet offre plusieurs avantages :
La documentation des packages NuGet fournit des options de configuration avancées pour des scénarios spécifiques tels que le déploiement Azure ou les conteneurs Docker .
Maintenant que nous disposons du logiciel, nous pouvons générer des PDF , ajuster les paramètres , ajouter du texte et des images personnalisés et manipuler les PDF pour répondre aux exigences de notre projet. IronPDF offre des fonctionnalités complètes pour créer de nouveaux PDF , modifier ceux existants et même convertir différents formats comme des images en PDF ou du XML en PDF .
ChromePdfRenderer ?Dans le code ci-dessous, nous avons utilisé un formulaire C# pour illustrer comment créer un PDF avec la bibliothèque C# .NET . Dans cet exemple, nous avons un TextBox pour écrire notre propre texte et ensuite cliquer simplement sur un bouton pour créer un PDF. La classe ChromePdfRenderer offre le moyen le plus simple de générer des fichiers PDF à partir de différentes sources, y compris une chaîne HTML, des URLs web, ou des fichiers doc sous un autre moteur de rendu.
Le ChromePdfRenderer est au cœur du moteur de rendu d'IronPDF. Il utilise la même technologie que Google Chrome pour garantir que vos PDF s'affichent exactement comme dans un navigateur web moderne. Cela signifie un soutien total pour :
La gestion des erreurs est cruciale pour une génération de PDF fiable. IronPDF fournit des exceptions détaillées qui permettent d'identifier rapidement les problèmes. Voici une approche robuste pour la génération de PDF avec gestion des erreurs :
using IronPdf;
using System;
using System.IO;
public class PdfGenerator
{
public static bool CreatePdfSafely(string htmlContent, string outputPath)
{
try
{
var renderer = new ChromePdfRenderer();
// Configure rendering options for better results
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
// Generate the PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
// Ensure directory exists
string directory = Path.GetDirectoryName(outputPath);
if (!Directory.Exists(directory))
{
Directory.CreateDirectory(directory);
}
// Save the PDF
pdf.SaveAs(outputPath);
return true;
}
catch (Exception ex)
{
// Log the error (you can use your preferred logging framework)
Console.WriteLine($"PDF generation failed: {ex.Message}");
return false;
}
}
}Imports IronPdf
Imports System
Imports System.IO
Public Class PdfGenerator
Public Shared Function CreatePdfSafely(htmlContent As String, outputPath As String) As Boolean
Try
Dim renderer = New ChromePdfRenderer()
' Configure rendering options for better results
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20
renderer.RenderingOptions.PrintHtmlBackgrounds = True
' Generate the PDF
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
' Ensure directory exists
Dim directory As String = Path.GetDirectoryName(outputPath)
If Not Directory.Exists(directory) Then
Directory.CreateDirectory(directory)
End If
' Save the PDF
pdf.SaveAs(outputPath)
Return True
Catch ex As Exception
' Log the error (you can use your preferred logging framework)
Console.WriteLine($"PDF generation failed: {ex.Message}")
Return False
End Try
End Function
End ClassPour les scénarios d'erreur plus complexes, consultez les guides de dépannage qui traitent des problèmes courants tels que la gestion de la mémoire et les délais de rendu .
Comprendre quand utiliser le rendu HTML plutôt que la création directe de PDF vous aide à choisir la bonne approche. IronPDF excelle dans le rendu HTML car il offre :
Avantages du rendu HTML :
Utilisez le rendu HTML lorsque :
La manipulation directe des PDF est préférable pour :
// C# Program to create PDF from TextBox input using IronPDF
using IronPdf;
using System.Windows.Forms;
namespace readpdf
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
// Event handler for the button click
private void button1_Click(object sender, System.EventArgs e)
{
// Create a ChromePdfRenderer object to convert HTML to PDF
var HtmlLine = new ChromePdfRenderer();
// Retrieve the text from the TextBox
string text = textBox1.Text;
// Render the HTML as a PDF, wrapping the text in an <h1> tag
using var pdf = HtmlLine.RenderHtmlAsPdf("<h1>" + text + "</h1>");
// Save the PDF to a file called "custom.pdf"
pdf.SaveAs("custom.pdf");
// Show a confirmation message to the user
MessageBox.Show("Done!");
}
}
}' VB.NET Program to create PDF from TextBox input using IronPDF
Imports IronPdf
Imports System.Windows.Forms
Namespace readpdf
Public Partial Class Form1
Inherits Form
Public Sub New()
InitializeComponent()
End Sub
' Event handler for the button click
Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
' Create a ChromePdfRenderer object to convert HTML to PDF
Dim HtmlLine = New ChromePdfRenderer()
' Retrieve the text from the TextBox
Dim text As String = textBox1.Text
' Render the HTML as a PDF, wrapping the text in an <h1> tag
Using pdf = HtmlLine.RenderHtmlAsPdf("<h1>" & text & "</h1>")
' Save the PDF to a file called "custom.pdf"
pdf.SaveAs("custom.pdf")
End Using
' Show a confirmation message to the user
MessageBox.Show("Done!")
End Sub
End Class
End NamespaceNous avons utilisé une application Windows Forms en C# pour vous montrer le résultat parfait avec du texte personnalisé. En un seul clic, le texte dans le TextBox est converti en un PDF personnalisé. Cela ne nécessite qu'une seule ligne de code et est facile à comprendre. Pour des scénarios plus complexes, vous pourriez envisager la conversion CSHTML en PDF pour les applications MVC ou la génération de PDF Blazor pour les applications web modernes.
La méthode en un seul clic est efficace car IronPDF gère en interne tout le rendu complexe. Lorsque vous appelez RenderHtmlAsPdf(), IronPDF :
Cette simplicité fait IronPDF la solution idéale pour les scénarios de développement rapide où vous avez besoin de résultats rapides. La bibliothèque gère automatiquement les polices de caractères , l'intégration d'images et même l'exécution de JavaScript .
Bien que le format PDF soit le format de sortie principal, IronPDF prend en charge diverses options d'exportation et de conversion :
De plus, IronPDF peut importer des fichiers à partir de diverses sources :
IronPDF offre de nombreuses options de personnalisation via la classe RenderingOptions . Voici un exemple illustrant les personnalisations courantes :
using IronPdf;
// Create renderer with custom settings
var renderer = new ChromePdfRenderer();
// Page setup options
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Margins (in millimeters)
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
// Header and footer configuration
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
Height = 15,
HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>",
DrawDividerLine = true
};
// Additional options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.GrayScale = false;
renderer.RenderingOptions.Zoom = 100;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
// Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Generate PDF with all customizations
var pdf = renderer.RenderHtmlAsPdf("<h1>Customized PDF Output</h1>");
pdf.SaveAs("customized.pdf");Imports IronPdf
' Create renderer with custom settings
Dim renderer = New ChromePdfRenderer()
' Page setup options
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait
' Margins (in millimeters)
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
' Header and footer configuration
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
.Height = 15,
.HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>",
.DrawDividerLine = True
}
' Additional options
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.GrayScale = False
renderer.RenderingOptions.Zoom = 100
renderer.RenderingOptions.CreatePdfFormsFromHtml = True
' Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
' Generate PDF with all customizations
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Customized PDF Output</h1>")
pdf.SaveAs("customized.pdf")Pour des options de personnalisation plus avancées, explorez :
Read through and share the API Reference for all the functionality you need to work with PDFs in your .NET project. The comprehensive documentation covers everything from basic PDF creation to advanced features like digital signatures and form handling.
Référence API pour IronPDF
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 et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
