IronPDF vs Accusoft PDF Viewer : quelle bibliothèque C# est la meilleure pour convertir du HTML en PDF ?

Quelles sont les différentes façons de télécharger IronPDF ?

Téléchargez IronPDF.dll et ajoutez sa référence au projet. Les développeurs peuvent également utiliser Windows Installer pour une installation à l'échelle du système. Après cela, l'espace de noms IronPdf devient accessible via :

using IronPdf;

using IronPdf;

Désormais, les développeurs peuvent facilement accéder aux fonctions et classes fournies par IronPDF, notamment ChromePdfRenderer pour le rendu, la manipulation de documents PDF et les fonctionnalités de sécurité .

Comment installer IronPDF via le gestionnaire de packages NuGet ?

• Console du gestionnaire de paquets :

  Si vous utilisez la console du gestionnaire de packages, exécutez la commande suivante :

  _CODEBLOCK_1 _

• Gérer les paquets pour la solution :

  Si vous utilisez l'interface graphique du gestionnaire de packages NuGet , recherchez IronPDF dans la barre de recherche et installez-le. Pour les options d'installation avancées , y compris les packages spécifiques à la plateforme pour Linux , macOS ou Windows , consultez le guide d'installation .

How Do I Install `PrizmDoc` Viewer from Accusoft?

PrizmDoc Viewer comporte deux parties : le composant côté serveur appelé PrizmDoc Server qui se comporte comme une API RESTful, et le projet client qui envoie des requêtes à l'API et reçoit les réponses. Contrairement à IronPDF qui fonctionne localement sans dépendances externes , PrizmDoc nécessite une connexion réseau pour les opérations basées sur le cloud.

How Can I Access the `PrizmDoc` Server?

PrizmDoc Server est une application côté serveur qui reçoit des informations de base sous forme de documents (entrées) et convertit ces documents en fichiers PDF , puis renvoie les fichiers PDF convertis en tant que réponses (sorties). Il constitue le cœur technique du produit : un moteur de traitement et de conversion de documents. Les développeurs peuvent l'utiliser de deux manières différentes, toutes deux reposant sur la même structure et les mêmes techniques de programmation :

1. Auto-hébergé :

   Cette option nécessite la mise en place d'un serveur. Téléchargez PrizmDoc Server puis installez-le. Pour en savoir plus sur l'installation PrizmDoc Server sous Windows, cliquez ici.

   Remarque : Il nécessite au minimum 32 Go de RAM et un processeur à 4 cœurs pour des performances optimales. En revanche, les exigences système d'IronPDF sont beaucoup plus modestes.

2. Hébergé sur Cloud:

   Ce service basé sur le cloud élimine le besoin de mettre en place un serveur. Pour utiliser cette option, créez un compte et copiez la API key depuis le menu API Key de la page d'accueil.

Tout d'abord, examinons la structure de base pour utiliser PrizmDoc Viewer afin de convertir des documents en fichiers PDF en interagissant directement avec Accusoft server à l'aide de WebClient() dans une application console C#.

Remarque : L'exemple suivant illustre le fonctionnement conceptuel des fichiers PDF PrizmDoc . Il est long, vous pouvez donc sauter cet exemple et passer directement à la comparaison .

Comment fonctionne la structure de travail d'Accusoft ?

Cet exemple convertit myWebpage.html en sample.pdf . Contrairement à la conversion HTML vers PDF simple d'IronPDF , PrizmDoc nécessite plusieurs appels API.

Remarque : La bibliothèque Newtonsoft.Json doit être installée et référencée dans le projet.

Commencez par ajouter les bibliothèques suivantes au projet :

using System;
using System.IO;
using System.Net;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json.Linq; // Install Newtonsoft.Json via NuGet Package Manager

using System;
using System.IO;
using System.Net;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json.Linq; // Install Newtonsoft.Json via NuGet Package Manager

Créez ensuite une variable publique Accusoft API Key et collez-y la clé API :

static string ApiKey = "Your-API-KEY";

static string ApiKey = "Your-API-KEY";

Il existe 3 étapes pour traiter les fichiers PDF avec PrizmDoc Viewer :

1. Téléversez un fichier sur le serveur PrizmDoc .
2. Convertissez le fichier téléchargé.
3. Téléchargez le fichier converti depuis le serveur PrizmDoc .

Chaque étape est gérée par une fonction distincte :

static void Main(string[] args)
{
    //---Upload file to Server---
    JObject uploadResults = UploadToServer("myWebpage.html").Result;
    string fileID = (string)uploadResults.SelectToken("fileId");
    string affinityToken = (string)uploadResults.SelectToken("affinityToken");

    //---Convert the uploaded file to PDF---
    JObject convertResults = Convert(affinityToken, fileID).Result;
    string processId = (string)convertResults.SelectToken("processId");
    affinityToken = (string)convertResults.SelectToken("affinityToken");

    //---Check the status that conversion is completed---
    JObject convertStatusResults = ConvertStatus(processId, affinityToken).Result;
    string convertStatus = (string)convertStatusResults.SelectToken("state");

    //---Continuously checking whether conversion completed---
    while (!(convertStatus.Equals("complete")))
    {
        System.Threading.Thread.Sleep(30000);
        convertStatusResults = ConvertStatus(processId, affinityToken).Result;
        convertStatus = (string)convertStatusResults.SelectToken("state");
    }

    //---Download the converted file from server---
    string newFileID = (string)convertStatusResults.SelectToken("output.results[0].fileId");
    DownloadFromServer(affinityToken, newFileID, "sample.pdf").Wait();

    Console.WriteLine("PDF file created successfully...!");
    Console.ReadKey();
}

static void Main(string[] args)
{
    //---Upload file to Server---
    JObject uploadResults = UploadToServer("myWebpage.html").Result;
    string fileID = (string)uploadResults.SelectToken("fileId");
    string affinityToken = (string)uploadResults.SelectToken("affinityToken");

    //---Convert the uploaded file to PDF---
    JObject convertResults = Convert(affinityToken, fileID).Result;
    string processId = (string)convertResults.SelectToken("processId");
    affinityToken = (string)convertResults.SelectToken("affinityToken");

    //---Check the status that conversion is completed---
    JObject convertStatusResults = ConvertStatus(processId, affinityToken).Result;
    string convertStatus = (string)convertStatusResults.SelectToken("state");

    //---Continuously checking whether conversion completed---
    while (!(convertStatus.Equals("complete")))
    {
        System.Threading.Thread.Sleep(30000);
        convertStatusResults = ConvertStatus(processId, affinityToken).Result;
        convertStatus = (string)convertStatusResults.SelectToken("state");
    }

    //---Download the converted file from server---
    string newFileID = (string)convertStatusResults.SelectToken("output.results[0].fileId");
    DownloadFromServer(affinityToken, newFileID, "sample.pdf").Wait();

    Console.WriteLine("PDF file created successfully...!");
    Console.ReadKey();
}

1. Télécharger le fichier sur le serveur:

public static async Task<JObject> UploadToServer(string fileToUpload)
{
    FileInfo input = new FileInfo(fileToUpload);
    if (input == null)
    {
        throw new ArgumentException("Missing parameter input", nameof(input));
    }
    var fileName = input.Name;
    var endpoint = new Uri("___PROTECTED_URL_123___");
    using (var client = new WebClient())
    {
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Content-Type", "application/octet-stream");
        using (var reader = new BinaryReader(input.OpenRead()))
        {
            var data = reader.ReadBytes((int)reader.BaseStream.Length);
            var results = await client.UploadDataTaskAsync(endpoint, "POST", data);
            string getResult = Encoding.ASCII.GetString(results);
            return JObject.Parse(getResult);
        }
    }
}

public static async Task<JObject> UploadToServer(string fileToUpload)
{
    FileInfo input = new FileInfo(fileToUpload);
    if (input == null)
    {
        throw new ArgumentException("Missing parameter input", nameof(input));
    }
    var fileName = input.Name;
    var endpoint = new Uri("___PROTECTED_URL_123___");
    using (var client = new WebClient())
    {
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Content-Type", "application/octet-stream");
        using (var reader = new BinaryReader(input.OpenRead()))
        {
            var data = reader.ReadBytes((int)reader.BaseStream.Length);
            var results = await client.UploadDataTaskAsync(endpoint, "POST", data);
            string getResult = Encoding.ASCII.GetString(results);
            return JObject.Parse(getResult);
        }
    }
}

2. convertir le fichier téléchargé en PDF:

public static async Task<JObject> Convert(string affinityToken, string fileID)
{
    var endpoint = new Uri("___PROTECTED_URL_124___");
    using (var client = new WebClient())
    {
        client.Headers.Add("Content-Type", "application/json");
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Accusoft-Affinity-Token", affinityToken);
        JObject myJson =
            new JObject(
                new JProperty("input",
                    new JObject(
                        new JProperty("sources",
                            new JArray(
                                new JObject(
                                    new JProperty("fileId", fileID)
                                )
                            )
                        ),
                        new JProperty("dest",
                            new JObject(
                                new JProperty("format", "pdf")
                            )
                        )
                    )
                )
            );
        string results = await client.UploadStringTaskAsync(endpoint, "POST", myJson.ToString());
        return JObject.Parse(results);
    }
}

public static async Task<JObject> Convert(string affinityToken, string fileID)
{
    var endpoint = new Uri("___PROTECTED_URL_124___");
    using (var client = new WebClient())
    {
        client.Headers.Add("Content-Type", "application/json");
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Accusoft-Affinity-Token", affinityToken);
        JObject myJson =
            new JObject(
                new JProperty("input",
                    new JObject(
                        new JProperty("sources",
                            new JArray(
                                new JObject(
                                    new JProperty("fileId", fileID)
                                )
                            )
                        ),
                        new JProperty("dest",
                            new JObject(
                                new JProperty("format", "pdf")
                            )
                        )
                    )
                )
            );
        string results = await client.UploadStringTaskAsync(endpoint, "POST", myJson.ToString());
        return JObject.Parse(results);
    }
}

Le JSON suivant est la valeur résultante de l'objet myJson :

{
  "input": {
    "sources": 
    [
      {"fileId": "Auto Generated FileId Value"}
    ],
    "dest": {
      "format": "pdf"
    }
  }
}

Vérifier si la conversion est terminée ou non

public static async Task<JObject> ConvertStatus(string processId, string affinityToken)
{
    string endpoint = "___PROTECTED_URL_125___" + processId;
    using (var client = new WebClient())
    {
        client.BaseAddress = endpoint;
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Accusoft-Affinity-Token", affinityToken);
        string results = await client.DownloadStringTaskAsync(endpoint);
        return JObject.Parse(results);
    }
}

public static async Task<JObject> ConvertStatus(string processId, string affinityToken)
{
    string endpoint = "___PROTECTED_URL_125___" + processId;
    using (var client = new WebClient())
    {
        client.BaseAddress = endpoint;
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Accusoft-Affinity-Token", affinityToken);
        string results = await client.DownloadStringTaskAsync(endpoint);
        return JObject.Parse(results);
    }
}

<Téléchargez le fichier converti à partir du serveur

public static async Task DownloadFromServer(string affinityToken, string fileId, string outfile)
{
    var endpoint = new Uri("___PROTECTED_URL_126___" + fileId);

    using (var client = new WebClient())
    {
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Accusoft-Affinity-Token", affinityToken);
        FileInfo output = new FileInfo(outfile);

        using (var writeStream = output.Create())
        {
            var results = await client.DownloadDataTaskAsync(endpoint);
            await writeStream.WriteAsync(results, 0, results.Length);
        }
    }
}

public static async Task DownloadFromServer(string affinityToken, string fileId, string outfile)
{
    var endpoint = new Uri("___PROTECTED_URL_126___" + fileId);

    using (var client = new WebClient())
    {
        client.Headers.Add("acs-api-key", ApiKey);
        client.Headers.Add("Accusoft-Affinity-Token", affinityToken);
        FileInfo output = new FileInfo(outfile);

        using (var writeStream = output.Create())
        {
            var results = await client.DownloadDataTaskAsync(endpoint);
            await writeStream.WriteAsync(results, 0, results.Length);
        }
    }
}

L'exemple ci-dessus exige un effort considérable. Pour minimiser la charge de travail, Accusoft a introduit une bibliothèque .NET nommée Accusoft.PrizmDocServerSDK , un wrapper autour de l'API REST du serveur PrizmDoc . Examinons comment installer et utiliser cette bibliothèque dans les projets .NET.

How Do I Install Accusoft.`PrizmDocServer`SDK?

Il existe deux façons d'installer le wrapper.

• Console du gestionnaire de paquets :

  Si vous utilisez la console du gestionnaire de packages, exécutez la commande suivante :

  _CODEBLOCK_10 _

• Gérer les paquets pour la solution :

  Si vous utilisez l'interface graphique du gestionnaire de packages NuGet, recherchez Accusoft.PrizmDocServerSDK dans la barre de recherche et installez-le.

Désormais, les développeurs peuvent facilement accéder à l'espace de noms Accusoft.PrizmDocServer et l'utiliser :

using Accusoft.PrizmDocServer;

using Accusoft.PrizmDocServer;

Tutoriels pratiques

Comment IronPDF convertit-il le HTML en PDF ?

using IronPdf;

static void Main(string[] args)
{
    // Create rendering converter
    var converter = new ChromePdfRenderer();
    // Render HTML file to PDF
    using var PDF = converter.RenderHTMLFileAsPdf("myWebPage.html");
    // Save to target location
    PDF.SaveAs("sample.pdf");
}

using IronPdf;

static void Main(string[] args)
{
    // Create rendering converter
    var converter = new ChromePdfRenderer();
    // Render HTML file to PDF
    using var PDF = converter.RenderHTMLFileAsPdf("myWebPage.html");
    // Save to target location
    PDF.SaveAs("sample.pdf");
}

Le code ci-dessus crée un fichier sample.pdf et l'enregistre dans le dossier bin>debug du projet. IronPDF prend également en charge les chaînes HTML , les URL et même les fichiers ZIP contenant du HTML comme sources d'entrée.

Les développeurs peuvent également spécifier n'importe quel chemin comme ceci : PDF.SaveAs("E:/sample.pdf"); ou enregistrer dans un flux en mémoire pour les déploiements dans le cloud.

Pour en savoir plus sur l'utilisation d'IronPDF pour la gestion des fichiers PDF, consultez la documentation.

À présent, effectuons la même tâche en utilisant PrizmDoc Viewer à des fins de comparaison.

Comment PrizmDoc Viewer convertit-il le HTML en PDF ?

Dans la section consacrée à l'installation PrizmDoc Viewer, l'obtention de la Accusoft API Key a été abordée. Voici comment l'utiliser.

Tout d'abord, envoyez une requête au serveur PrizmDoc et recevez une réponse. Ce processus prend du temps et nécessite une programmation asynchrone . IronPDF prend également en charge les méthodes asynchrones pour des performances améliorées.

Remarque : Assurez-vous que le système est connecté à Internet lors de la création de fichiers PDF à l'aide des services cloud de PrizmDoc Viewer.

using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    ChromePdfRenderer().GetAwaiter().GetResult();
}

private static async Task ChromePdfRenderer()
{
    // Instantiate PrizmDocServerClient object
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_127___", "Your-API-KEY");
    // Specify HTML file and convert it to a PDF.
    ConversionResult result = await prizmDocServer.ConvertToPdfAsync("myWebPage.html");
    // Save PDF file to the target location
    await result.RemoteWorkFile.SaveAsync("sample.pdf");
}

using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    ChromePdfRenderer().GetAwaiter().GetResult();
}

private static async Task ChromePdfRenderer()
{
    // Instantiate PrizmDocServerClient object
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_127___", "Your-API-KEY");
    // Specify HTML file and convert it to a PDF.
    ConversionResult result = await prizmDocServer.ConvertToPdfAsync("myWebPage.html");
    // Save PDF file to the target location
    await result.RemoteWorkFile.SaveAsync("sample.pdf");
}

Pour en savoir plus sur l'utilisation de PrizmDoc Viewer, consultez la documentation.

Quelle bibliothèque offre la conversion HTML vers PDF la plus simple ?

Ces exemples démontrent qu'IronPDF offre une approche plus simple et plus rapide pour la création de fichiers PDF. IronPDF propose également des options de rendu permettant d'affiner le résultat, notamment des formats de papier personnalisés , des marges et des paramètres d'affichage .

Comment IronPDF convertit-il les images en PDF ?

using IronPdf;

static void Main(string[] args)
{
    // Specify the image to be converted
    using var converted = ImageToPdfConverter.ImageToPdf("google.png");
    // Save PDF file to the target location
    converted.SaveAs("sample.pdf");
}

using IronPdf;

static void Main(string[] args)
{
    // Specify the image to be converted
    using var converted = ImageToPdfConverter.ImageToPdf("google.png");
    // Save PDF file to the target location
    converted.SaveAs("sample.pdf");
}

IronPDF prend également en charge la conversion TIFF multi-images , l'intégration d'images provenant d'Azure Blob Storage et l'intégration d'images Base64 .

Sortie :

Cette capture d'écran montre le fichier PDF sample.pdf nouvellement créé à l'aide du code ci-dessus :

Créer un fichier PDF à partir d'une image avec IronPDF est simple. À présent, effectuons la même tâche à l'aide de PrizmDoc Viewer et examinons le fichier PDF généré.

Comment PrizmDoc Viewer convertit-il les images en PDF ?

using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    ImageToPDF().GetAwaiter().GetResult();
}

private static async Task ImageToPDF()
{
    // Instantiate PrizmDocServerClient object
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_128___", "Your-API-KEY");
    // Specify the image to be converted
    ConversionResult results = await prizmDocServer.ConvertToPdfAsync("google.png");
    // Save PDF file to the target location
    await results.RemoteWorkFile.SaveAsync("sample.pdf");
}

using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    ImageToPDF().GetAwaiter().GetResult();
}

private static async Task ImageToPDF()
{
    // Instantiate PrizmDocServerClient object
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_128___", "Your-API-KEY");
    // Specify the image to be converted
    ConversionResult results = await prizmDocServer.ConvertToPdfAsync("google.png");
    // Save PDF file to the target location
    await results.RemoteWorkFile.SaveAsync("sample.pdf");
}

Résultat : Cette capture d'écran montre le fichier PDF sample.pdf nouvellement créé à partir du code ci-dessus :

Quelle bibliothèque nécessite le moins de code pour la conversion d'images en PDF ?

IronPDF ne nécessite que deux lignes de code. En revanche, l'utilisation du serveur PrizmDoc implique davantage de lignes de code avec une programmation asynchrone. Le fichier de sortie d'IronPDF génère également automatiquement un document pleine page utilisable. IronPDF offre des options supplémentaires pour le positionnement des images et les conversions d'images multiples .

Comment IronPDF fusionne-t-il les fichiers PDF ?

using IronPdf;
using System.Collections.Generic;

static void Main(string[] args)
{
    // Create rendering converter  
    var Renderer = new IronPdf.ChromePdfRenderer();
    // Create a list of pdf files
    var PDFs = new List<PdfDocument>();
    PDFs.Add(PdfDocument.FromFile("A.pdf"));
    PDFs.Add(PdfDocument.FromFile("B.pdf"));
    PDFs.Add(PdfDocument.FromFile("C.pdf"));
    // Merge the list of pdf file
    using PdfDocument PDF = PdfDocument.Merge(PDFs);
    // Save merged file to the target location
    PDF.SaveAs("sample.pdf");

    foreach(var pdf in PDFs)
    {
        pdf.Dispose();
    }
}

using IronPdf;
using System.Collections.Generic;

static void Main(string[] args)
{
    // Create rendering converter  
    var Renderer = new IronPdf.ChromePdfRenderer();
    // Create a list of pdf files
    var PDFs = new List<PdfDocument>();
    PDFs.Add(PdfDocument.FromFile("A.pdf"));
    PDFs.Add(PdfDocument.FromFile("B.pdf"));
    PDFs.Add(PdfDocument.FromFile("C.pdf"));
    // Merge the list of pdf file
    using PdfDocument PDF = PdfDocument.Merge(PDFs);
    // Save merged file to the target location
    PDF.SaveAs("sample.pdf");

    foreach(var pdf in PDFs)
    {
        pdf.Dispose();
    }
}

Le code ci-dessus crée un fichier sample.pdf , qui combine A.pdf , B.pdf et C.pdf . IronPDF prend également en charge l'ajout et la copie de pages entre les fichiers PDF ainsi que la division des fichiers PDF .

À présent, effectuons la même tâche en utilisant PrizmDoc Viewer.

Comment PrizmDoc Viewer fusionne-t-il les fichiers PDF ?

using System.Threading.Tasks;
using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    PdfMerge().GetAwaiter().GetResult();
}

private static async Task PdfMerge()
{
    // Instantiate PrizmDocServerClient object
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_129___", "Your-API-KEY");
    // Pass the list of pdf files to PrizmDoc Server
    ConversionResult result = await prizmDocServer.CombineToPdfAsync(
        new []
        {
            new ConversionSourceDocument("A.pdf"),
            new ConversionSourceDocument("B.pdf"),
            new ConversionSourceDocument("C.pdf"),
        });
    // Save merged file to the target location
    await result.RemoteWorkFile.SaveAsync("sample.pdf");
}

using System.Threading.Tasks;
using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    PdfMerge().GetAwaiter().GetResult();
}

private static async Task PdfMerge()
{
    // Instantiate PrizmDocServerClient object
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_129___", "Your-API-KEY");
    // Pass the list of pdf files to PrizmDoc Server
    ConversionResult result = await prizmDocServer.CombineToPdfAsync(
        new []
        {
            new ConversionSourceDocument("A.pdf"),
            new ConversionSourceDocument("B.pdf"),
            new ConversionSourceDocument("C.pdf"),
        });
    // Save merged file to the target location
    await result.RemoteWorkFile.SaveAsync("sample.pdf");
}

Le code ci-dessus crée également un fichier sample.pdf , qui combine les fichiers A.pdf , B.pdf et C.pdf .

Comment IronPDF gère-t-il les en-têtes et pieds de page des fichiers PDF ?

Pour gérer les en-têtes et les pieds de page des fichiers PDF, IronPDF fournit une propriété sur la classe ChromePdfRenderer nommée RenderingOptions qui peut être utilisée comme suit :

• Pour l'en-tête:

  _CODEBLOCK_19 _

• Pour le pied de page:

  _CODEBLOCK_20 _

Les propriétés suivantes peuvent être définies lors de l'initialisation TextHeaderFooter() :

• CenterText pour imprimer du texte au centre de l'en-tête ou du pied de page
• LeftText permet d'imprimer du texte à gauche de l'en-tête ou du pied de page.
• RightText permet d'imprimer du texte à droite de l'en-tête ou du pied de page.
• DrawDividerLine trace une ligne séparant le contenu de la page de l'en-tête ou du pied de page.
• FontFamily pour spécifier la famille de polices de l'en-tête ou du pied de page
• FontSize pour spécifier la taille de la police de l'en-tête ou du pied de page
• L'espacement ajuste l'espace entre le contenu de la page et l'en-tête ou le pied de page.

Les attributs prédéfinis suivants permettent de définir le contenu de l'en-tête ou du pied de page. Elles sont écrites entre accolades { } :

• {page} affiche le numéro de la page actuelle dans l'en-tête ou le pied de page.
• {total-pages} affiche le nombre total de pages dans l'en-tête ou le pied de page.
• {url} affiche l'URL de la page rendue
• {date} affiche la date actuelle dans l'en-tête ou le pied de page
• {time} affiche l'heure actuelle dans l'en-tête ou le pied de page
• {html-title} affiche le titre de la page web rendue dans l'en-tête ou le pied de page.
• {pdf-title} imprime le titre du document dans l'en-tête ou le pied de page

Pour en savoir plus sur l'utilisation des en-têtes et des pieds de page avec IronPDF, consultez la documentation. IronPDF prend également en charge les en-têtes et pieds de page HTML pour les mises en page plus complexes.

L'exemple suivant illustre la mise en œuvre du cas d'utilisation et démontre comment utiliser les propriétés ci-dessus :

using IronPdf;

static void Main(string[] args)
{
    // Create rendering converter
    var converter = new ChromePdfRenderer();
    // Setting Header properties
    converter.RenderingOptions.TextHeader = new TextHeaderFooter()
    {
        DrawDividerLine = true,
        LeftText = "Page Title",
        RightText = "{date} {time}",
        FontSize = 13
    };
    // Setting footer properties
    converter.RenderingOptions.TextFooter = new TextHeaderFooter()
    {
        RightText = "Page {page} of {total-pages}",
        FontSize = 12
    };
    // Specify the file to be converted
    using var PDF = converter.RenderHTMLFileAsPdf("myWebPage.html");
    // Save to target location
    PDF.SaveAs("sample.pdf");
}

using IronPdf;

static void Main(string[] args)
{
    // Create rendering converter
    var converter = new ChromePdfRenderer();
    // Setting Header properties
    converter.RenderingOptions.TextHeader = new TextHeaderFooter()
    {
        DrawDividerLine = true,
        LeftText = "Page Title",
        RightText = "{date} {time}",
        FontSize = 13
    };
    // Setting footer properties
    converter.RenderingOptions.TextFooter = new TextHeaderFooter()
    {
        RightText = "Page {page} of {total-pages}",
        FontSize = 12
    };
    // Specify the file to be converted
    using var PDF = converter.RenderHTMLFileAsPdf("myWebPage.html");
    // Save to target location
    PDF.SaveAs("sample.pdf");
}

Sortie: La capture d'écran du fichier PDF nouvellement créé sample.pdf par le code ci-dessus :

L'utilisation d'IronPDF pour la gestion des en-têtes et des pieds de page implique un langage intuitif lors de la création de fichiers PDF. L'exemple suivant montre comment PrizmDoc Viewer gère les en-têtes et les pieds de page.

Comment PrizmDoc Viewer gère-t-il les en-têtes et pieds de page des fichiers PDF ?

PrizmDoc Viewer fournit la classe HeaderFooterOptions pour gérer les en-têtes et les pieds de page, avec les propriétés suivantes :

• Lines spécifie la ou les lignes d'en-tête et de pied de page, chaque ligne ayant les propriétés suivantes : Gauche affiche le texte à gauche de la ligne d'en-tête ou de pied de page Centrer imprime le texte au centre de la ligne d'en-tête ou de pied de page Right * imprime le texte à droite de la ligne d'en-tête ou de pied de page
• FontFamily pour spécifier la famille de polices du texte d'en-tête ou de pied de page
• FontSize pour spécifier la taille de la police du texte d'en-tête ou de pied de page
• Couleur pour spécifier la couleur du texte d'en-tête ou de pied de page

Pour en savoir plus sur la configuration des en-têtes et pieds de page PDF à l'aide du serveur PrizmDoc , consultez la documentation.

L'exemple montre comment mettre en œuvre le cas d'utilisation en utilisant les propriétés ci-dessus :

using System.Threading.Tasks;
using System.Collections.Generic;
using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    SetHeaderFooter().GetAwaiter().GetResult();
}

private static async Task SetHeaderFooter()
{
    // Instantiate PrizmDocServerClient object with Header and footer properties
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_130___", "Your-API-KEY");

    ConversionResult result = await prizmDocServer.ConvertToPdfAsync(
        "myWebPage.html",
        header: new HeaderFooterOptions
        {
            Lines = new List<HeaderFooterLine>
            {
                new HeaderFooterLine { Left = "Page Title", Right = DateTime.Now.ToString() }
            },
        },
        footer: new HeaderFooterOptions
        {
            Lines = new List<HeaderFooterLine>
            {
                new HeaderFooterLine { Right = "Page {{pageNumber}} of {{pageCount}}" },
            },
        });

    // Save to the target location
    await result.RemoteWorkFile.SaveAsync("sample.pdf");
}

using System.Threading.Tasks;
using System.Collections.Generic;
using Accusoft.PrizmDocServer;
using Accusoft.PrizmDocServer.Conversion;

static void Main(string[] args)
{
    SetHeaderFooter().GetAwaiter().GetResult();
}

private static async Task SetHeaderFooter()
{
    // Instantiate PrizmDocServerClient object with Header and footer properties
    var prizmDocServer = new PrizmDocServerClient("___PROTECTED_URL_130___", "Your-API-KEY");

    ConversionResult result = await prizmDocServer.ConvertToPdfAsync(
        "myWebPage.html",
        header: new HeaderFooterOptions
        {
            Lines = new List<HeaderFooterLine>
            {
                new HeaderFooterLine { Left = "Page Title", Right = DateTime.Now.ToString() }
            },
        },
        footer: new HeaderFooterOptions
        {
            Lines = new List<HeaderFooterLine>
            {
                new HeaderFooterLine { Right = "Page {{pageNumber}} of {{pageCount}}" },
            },
        });

    // Save to the target location
    await result.RemoteWorkFile.SaveAsync("sample.pdf");
}

$vbLabelText   $csharpLabel

Sortie :

Capture d'écran du fichier PDF nouvellement créé par le code ci-dessus :