Affiner les convertisseurs dans .NET avec Aspose.HTML

Introduction

Aspose.HTML pour .NET est une bibliothèque puissante qui permet aux développeurs de manipuler et de convertir des documents HTML dans différents formats. Que vous ayez besoin de convertir du HTML en PDF, XPS ou images, ou d’effectuer d’autres tâches liées au HTML, Aspose.HTML fournit un ensemble d’outils robustes pour vous aider à faire le travail.

Dans ce didacticiel, nous explorerons certaines fonctionnalités essentielles d’Aspose.HTML pour .NET et fournirons des explications étape par étape pour chaque exemple. À la fin de ce didacticiel, vous aurez une solide compréhension de la façon d’utiliser Aspose.HTML pour .NET dans vos applications .NET.

Conditions préalables

Avant de plonger dans les exemples, assurez-vous que les conditions préalables suivantes sont remplies :

  • Aspose.HTML pour .NET : la bibliothèque Aspose.HTML pour .NET doit être installée. Vous pouvez le télécharger depuis lelien de téléchargement.

  • Licence temporaire (facultatif) : Si vous n’avez pas de licence valide, vous pouvez obtenir une licence temporaire auprès deici.

Explorons maintenant quelques cas d’utilisation courants avec Aspose.HTML pour .NET.

Importer des espaces de noms

Dans votre code C#, commencez par importer les espaces de noms nécessaires :

using Aspose.Html;
using Aspose.Html.Rendering.Pdf;
using Aspose.Html.Rendering.Image;
using Aspose.Html.Rendering.Xps;
using Aspose.Html.Rendering.Pdf.Encryption;
using Aspose.Html.Drawing;

Convertir HTML en PDF

Étape 1 : préparer le code HTML

var code = @"<span>Hello World!!</span>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer un périphérique PDF et spécifier le fichier de sortie

using (var device = new PdfDevice("output.pdf"))

Étape 4 : rendre le HTML en PDF

document.RenderTo(device);

Cet exemple convertit un extrait HTML en un document PDF. Vous pouvez personnaliser le code HTML et le fichier de sortie selon vos besoins.

Définir une taille de page personnalisée

Étape 1 : préparer le code HTML

var code = @"<span>Hello World!!</span>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer des options de rendu PDF

var options = new PdfRenderingOptions()
{
    PageSetup =
    {
        AnyPage = new Page(
            new Size(
                Length.FromInches(5),
                Length.FromInches(2)))
    }
};

Étape 4 : Créer un périphérique PDF et spécifier les options et le fichier de sortie

using (var device = new PdfDevice(options, "output.pdf"))

Étape 5 : rendre le HTML en PDF

document.RenderTo(device);

Cet exemple montre comment définir une taille de page personnalisée pour le document PDF résultant.

Ajuster la résolution

Étape 1 : Préparez le code HTML et enregistrez-le dans un fichier

var code = @"
    <style>
    p
    { 
        background: blue; 
    }
    @media(min-resolution: 300dpi)
    {
        p 
        { 
            /* high-resolution screen color */
            background: green
        }
    }
    </style>
    <p>Hello World!!</p>";
System.IO.File.WriteAllText("document.html", code);

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument("document.html"))

Étape 3 : Créer des options de rendu PDF pour basse résolution

var options = new PdfRenderingOptions()
{
    HorizontalResolution = 50,
    VerticalResolution = 50
};

Étape 4 : Créer un périphérique PDF et spécifier les options et le fichier de sortie pour la basse résolution

using (var device = new PdfDevice(options, "output_resolution_50.pdf"))

Étape 5 : rendre le HTML au format PDF pour une basse résolution

document.RenderTo(device);

Étape 6 : Créer des options de rendu PDF pour la haute résolution

options = new PdfRenderingOptions()
{
    HorizontalResolution = 300,
    VerticalResolution = 300
};

Étape 7 : Créer un périphérique PDF et spécifier les options et le fichier de sortie pour la haute résolution

using (var device = new PdfDevice(options, "output_resolution_300.pdf"))

Étape 8 : rendre le HTML au format PDF pour une haute résolution

document.RenderTo(device);

Cet exemple illustre comment ajuster la résolution lors du rendu HTML au format PDF, en tenant compte des écrans basse et haute résolution.

Spécifier la couleur d’arrière-plan

Étape 1 : Préparez le code HTML et enregistrez-le dans un fichier

var code = @"<p>Hello World!!</p>";
System.IO.File.WriteAllText("document.html", code);

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument("document.html"))

Étape 3 : initialiser les options de rendu PDF avec la couleur d’arrière-plan

var options = new PdfRenderingOptions()
{
    BackgroundColor = System.Drawing.Color.Cyan
};

Étape 4 : Créer un périphérique PDF et spécifier les options et le fichier de sortie

using (var device = new PdfDevice(options, "output.pdf"))

Étape 5 : rendre le HTML en PDF

document.RenderTo(device);

Cet exemple montre comment spécifier une couleur d’arrière-plan lors de la conversion de HTML en PDF.

Définir les tailles de page gauche et droite

Étape 1 : préparer le code HTML

var code = @"<style>div { page-break-after: always; }</style>
    <div>First Page</div>
    <div>Second Page</div>
    <div>Third Page</div>
    <div>Fourth Page</div>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer des options de rendu PDF avec des tailles de page gauche et droite

var options = new PdfRenderingOptions();
options.PageSetup.SetLeftRightPage(
    new Page(new Size(400, 200)),
    new Page(new Size(400, 100))
);

Étape 4 : Créer un périphérique PDF et spécifier les options et le fichier de sortie

using (var device = new PdfDevice(options, "output.pdf"))

Étape 5 : rendre le HTML en PDF

document.RenderTo(device);

Cet exemple montre comment définir différentes tailles de page pour les pages gauche et droite lors de la conversion HTML en PDF.

Ajuster la taille de la page au contenu

Étape 1 : préparer le code HTML

var code = @"<style>
    div { page-break-after: always; }
</style>
<div style='border: 1px solid red; width: 400px'>First Page</div>
<div style='border: 1px solid red; width: 600px'>Second Page</div>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer des options de rendu PDF

var options = new PdfRenderingOptions();
options.PageSetup.AnyPage = new Page(new Size(500, 200));
options.PageSetup.AdjustToWidestPage = true;

Étape 4 : Créer un périphérique PDF et spécifier les options et le fichier de sortie

using (var device = new PdfDevice(options, "output.pdf"))

Étape 5 : rendre le HTML en PDF

document.RenderTo(device);

Cet exemple montre comment ajuster la taille de la page au contenu le plus large lors de la conversion HTML en PDF.

Spécifier les autorisations PDF

Étape 1 : préparer le code HTML

var code = @"<div>Hello World!!</div>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer des options de rendu PDF avec des autorisations

var options = new PdfRenderingOptions();
options.Encryption = new PdfEncryptionInfo(
    "user_pwd",
    "owner_pwd",
    PdfPermissions.PrintDocument,
    PdfEncryptionAlgorithm.RC4_128
);

Étape 4 : Créer un périphérique PDF et spécifier les options et le fichier de sortie

using (var device = new PdfDevice(options, "output.pdf"))

Étape 5 : rendre le HTML en PDF

document.RenderTo(device);

Cet exemple montre comment spécifier les autorisations et le cryptage lors de la conversion de HTML en PDF protégé.

Spécifier les options spécifiques à l’image

Étape 1 : préparer le code HTML

var code = @"<div>Hello World!!</div>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer des options de rendu d’image

var options = new ImageRenderingOptions()
{
    Format = ImageFormat.Jpeg,
    SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.None,
    VerticalResolution = Resolution.FromDotsPerInch(75),
    HorizontalResolution = Resolution.FromDotsPerInch(75),
};

Étape 4 : Créer un périphérique d’image et spécifier les options et le fichier de sortie

using (var device = new ImageDevice(options, "output.jpg"))

Étape 5 : rendre le HTML en image

document.RenderTo(device);

Cet exemple montre comment convertir du HTML en image avec des options de rendu spécifiques, telles que le format, la résolution et le mode de lissage.

Spécifier les options de rendu XPS

Étape 1 : préparer le code HTML

var code = @"<span>Hello World!!</span>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : Créer des options de rendu XPS avec la taille de la page

var options = new XpsRenderingOptions();
options.PageSetup.AnyPage = new Page(
    new Size(
        Length.FromInches(5),
        Length.FromInches(2)
    )
);

Étape 4 : Créer un périphérique XPS et spécifier les options et le fichier de sortie

using (var device = new XpsDevice(options, "output.xps"))

Étape 5 : rendre le HTML vers XPS

document.RenderTo(device);

Cet exemple montre comment convertir du HTML en XPS avec une taille de page et des options de rendu personnalisées.

Combiner plusieurs documents HTML en PDF

Étape 1 : préparer le code HTML pour plusieurs documents

var code1 = @"<br><span style='color: green'>Hello World!!</span>";
var code2 = @"<br><span style='color: blue'>Hello World!!</span>";
var code3 = @"<br><span style='color: red'>Hello World!!</span>";

Étape 2 : Créer des documents HTML à fusionner

using (var document1 = new HTMLDocument(code1, "."))
using (var document2 = new HTMLDocument(code2, "."))
using (var document3 = new HTMLDocument(code3, "."))

Étape 3 : initialiser le moteur de rendu HTML

using (HTMLRenderer renderer = new HTMLRenderer())

Étape 4 : Créer un périphérique PDF pour une sortie fusionnée

using (var device = new PdfDevice("output.pdf"))

Étape 5 : Fusionner des documents HTML en PDF

renderer.Render(device, document1, document2, document3);

Cet exemple montre comment combiner plusieurs documents HTML en un seul fichier PDF à l’aide d’Aspose.HTML pour .NET.

Définir le délai d’expiration du rendu

Étape 1 : préparer le code HTML avec JavaScript

var code = @"
    <script>
        var count = 0;
        setInterval(function()
        {
            var element = document.createElement('div');
            var message = (++count) + '. ' + 'Hello World!!';
            var text = document.createTextNode(message);
            element.appendChild(text);
            document.body.appendChild(element);
        }, 1000);
    </script>";

Étape 2 : initialiser le document HTML

using (var document = new HTMLDocument(code, "."))

Étape 3 : initialiser le moteur de rendu HTML

using (HTMLRenderer renderer = new HTMLRenderer())

Étape 4 : Créer un périphérique PDF et définir le délai d’expiration du rendu

using (var device = new PdfDevice("output.pdf"))

Étape 5 : rendre le HTML au format PDF avec délai d’attente

renderer.Render(device, TimeSpan.FromSeconds(5), document);

Cet exemple montre comment définir un délai d’attente de rendu lors de la conversion de HTML en PDF, ce qui peut être utile lorsqu’il s’agit de contenu dynamique ou de scripts de longue durée.

Conclusion

Aspose.HTML pour .NET est une bibliothèque polyvalente qui permet aux développeurs de travailler efficacement avec des documents HTML. Dans ce didacticiel, nous avons couvert divers exemples, des conversions de base HTML en PDF à des fonctionnalités plus avancées telles que les tailles de page personnalisées, les résolutions et les autorisations. En suivant ces exemples, vous pouvez exploiter tout le potentiel d’Aspose.HTML pour .NET dans vos applications .NET.

Si vous avez des questions ou avez besoin d’aide supplémentaire, n’hésitez pas à visiter leForum Aspose.HTML pour obtenir du soutien et des conseils.

FAQ

T1. Qu’est-ce qu’Aspose.HTML pour .NET ?

A1 : Aspose.HTML pour .NET est une bibliothèque .NET qui permet aux développeurs de manipuler et de convertir des documents HTML par programme. Il offre un large éventail de fonctionnalités pour travailler avec du contenu HTML, notamment la conversion HTML en PDF, XPS et d’images, ainsi que des options de rendu avancées.

Q2. Où puis-je télécharger Aspose.HTML pour .NET ?

A2 : Vous pouvez télécharger Aspose.HTML pour .NET à partir dulien de téléchargement.

Q3. Ai-je besoin d’une licence pour utiliser Aspose.HTML pour .NET ?

A3 : Bien que vous puissiez utiliser Aspose.HTML pour .NET sans licence, il est recommandé d’obtenir une licence pour une utilisation en production afin de déverrouiller toutes les fonctionnalités et de supprimer tous les filigranes ou limitations.

Q4. Comment puis-je protéger mes fichiers PDF générés avec Aspose.HTML pour .NET ?

A4 : Vous pouvez spécifier les autorisations PDF et les paramètres de cryptage lors du rendu HTML au format PDF à l’aide d’Aspose.HTML pour .NET. Cela vous permet de contrôler qui peut accéder et modifier les fichiers PDF résultants.

Q5. Puis-je convertir du HTML vers d’autres formats comme XPS ou des images ?

R5 : Oui, Aspose.HTML pour .NET prend en charge la conversion du HTML vers divers formats, notamment PDF, XPS et images (par exemple, JPEG). Vous pouvez personnaliser les paramètres de conversion pour répondre à vos besoins spécifiques.

Générer un PDF crypté par PdfDevice dans .NET avec Aspose.HTML Utilisation de modèles HTML dans .NET avec Aspose.HTML