Convertir des pages ASPX en PDF en C#35 ; ASP.NET

Quand dois-je installer via DLL au lieu de NuGet?

Vous pouvez également télécharger la DLL IronPDF et l'installer manuellement dans le projet ou le GAC à partir de Télécharger le package IronPDF. Pour les installations spécifiques à Windows, consultez notre guide d'installation Windows.

N'oubliez pas d'ajouter cette déclaration en haut de tout fichier de classe cs utilisant IronPDF :

using IronPdf;

using IronPdf;

Comment contrôler le comportement d'affichage des PDF?

"InBrowser" comportement de fichier tente d'afficher le PDF directement dans le navigateur de l'utilisateur. Il s'agit d'une caractéristique commune aux navigateurs modernes, conformes aux normes.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

"Attachment" comportement de fichier fait que le PDF est téléchargé.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

Comment personnaliser le nom du fichier PDF?

Définissez le nom de fichier du document PDF en ajoutant un paramètre supplémentaire. Cela permet de contrôler le nom du fichier lorsque les utilisateurs le téléchargent ou l'enregistrent.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

Quelles sont les options d'impression PDF que je peux configurer ?

Contrôlez la sortie des PDF en ajoutant une instance de la classe IronPdf.ChromePdfRenderer. Référence API ChromePdfRenderer

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-3.cs

var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
{
    EnableJavaScript = false,
    //.. many more options available
};
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);

Les options de rendu PDF disponibles incluent :

• CreatePdfFormsFromHtml : Transforme les formulaires ASPX en formulaires PDF éditables. Voir créer des formulaires PDF.
• CssMediaType : Screen ou Print Styles CSS. Voir images de comparaison.
• CustomCssUrl : Applique une feuille de style CSS personnalisée à l'HTML avant le rendu. Chemin d'accès au fichier local ou URL distant.
• EnableMathematicalLaTex : Active/désactive le rendu des éléments LaTeX.
• EnableJavaScript : Exécute JavaScript avant le rendu. Idéal pour les applications Ajax/Angular. Voir Guide WaitFor.
• Javascript : JavaScript personnalisé à exécuter après le chargement du HTML mais avant le rendu.
• JavascriptMessageListener : Rappel pour les messages de la console JavaScript du navigateur.
• FirstPageNumber : Numéro de la page de départ pour les en-têtes/pieds de page. La valeur par défaut est 1.
• TableOfContents : Générer la table des matières à l'élément avec l'id "IronPdf-toc". Voir Guide TOC.
• TextHeader : Définit le contenu de l'en-tête en tant que texte. Prise en charge de la fusion de courriers électroniques et de l'établissement automatique de liens URL.
• TextFooter : Définit le contenu du pied de page en tant que texte. Prise en charge de la fusion de courriers électroniques et de l'établissement automatique de liens URL.
• HtmlHeader : Définit le contenu de l'en-tête en utilisant HTML.
• HtmlFooter : Définit le contenu du pied de page en utilisant HTML.
• MarginBottom : Marge inférieure en millimètres. Zéro pour borderless.
• MarginLeft : Marge gauche en millimètres. Zéro pour borderless.
• MarginRight : Marge droite en millimètres. Zéro pour borderless.
• MarginTop : Marge supérieure en millimètres. Zéro pour borderless.
• UseMarginsOnHeaderAndFooter : Utiliser les marges du document principal pour les en-têtes/pieds de page.
• PaperFit : Gestionnaire virtuel de mise en page. Inclut des options pour le comportement Chrome, le zoom, le CSS3 réactif, la mise à l'échelle de la page et le flux continu. Voir guideviewport.
• PaperOrientation : Orientation du PDF - Paysage ou Portrait.
• PageRotation : Rotation des pages d'un document existant. Voir exemples d'orientation.
• PaperSize : Taille du papier de sortie en utilisant System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeinCentimeters : Définit la taille du papier en centimètres.
• SetCustomPaperSizeInInches : Définit la taille du papier en pouces.
• SetCustomPaperSizeinMilimeters : Définit la taille du papier en millimètres.
• SetCustomPaperSizeinPixelsOrPoints : Définit la taille du papier en pixels ou en points.
• ForcePaperSize : Force la taille exacte du papier en le redimensionnant après la génération.
• PrintHtmlBackgrounds : Imprime les images d'arrière-plan HTML.
• GrayScale : Produit un PDF en niveaux de gris. Voir conversion en niveaux de gris.
• WaitFor : Configuration des mécanismes d'attente :
  • PageLoad : Rendu par défaut sans attente.
  • RenderDelay : Temps d'attente arbitraire.
  • Fonts : Attendre le chargement des polices.
  • JavaScript : Déclencher le rendu avec une fonction JavaScript.
  • éléments HTML : Recherche d'éléments spécifiques par ID, nom, balise ou sélecteur.
  • NetworkIdle : Attendre que le réseau soit inactif (0, 2 ou personnalisé).
• Title : Métadonnées du titre du document PDF. Voir guide des métadonnées.
• InputEncoding : Codage des caractères. UTF-8 est la valeur par défaut. Voir guideUTF-8.
• RequestContext : Contexte de demande pour le rendu.
• Timeout : Temps d'arrêt de rendu en secondes.

Comment mettre en place des en-têtes et des pieds de page ?

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-4.cs

using IronSoftware.Drawing;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                TextHeader = new IronPdf.TextHeaderFooter()
                {
                    CenterText = "Invoice",
                    DrawDividerLine = false,
                    Font = FontTypes.Arial,
                    FontSize = 12
                },
                TextFooter = new IronPdf.TextHeaderFooter()
                {
                    LeftText = "{date} - {time}",
                    RightText = "Page {page} of {total-pages}",
                    Font = IronSoftware.Drawing.FontTypes.Arial,
                    FontSize = 12,
                },
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);
        }
    }
}

Vous pouvez également générer des en-têtes et des pieds de page HTML à l'aide de la classe HtmlHeaderFooter, qui prend en charge les feuilles de style CSS, les images et les hyperliens.

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-5.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                MarginTop = 50, // make sufficiant space for an HTML header
                HtmlHeader = new IronPdf.HtmlHeaderFooter()
                {
                    HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"
                }
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions);
        }
    }
}

Comme nous l'avons vu dans nos exemples, fusionnez du texte dynamique ou du HTML dans les en-têtes/pieds de page à l'aide de caractères de remplissage :

• {page} : Numéro de page actuel.
• {total-pages} : Nombre total de pages.
• {url} : URL web à partir de laquelle le PDF a été rendu.
• {date} : Date du jour au format système.
• {time} : Heure au format 24 heures.
• {html-title} : Titre de la balise d'en-tête ASPX.
• {pdf-title} : Nom du fichier du document.