API de traitement HTML en C# – Aspose.HTML for .NET

Analysez le HTML, modifiez le DOM, convertissez des documents web et générez des fichiers de sortie dans les applications .NET.

Analyser, modifier et convertir du HTML en C#

Aspose.HTML for .NET est une bibliothèque de classes conçue pour traiter du contenu HTML dans les applications C#. La classe HTMLDocument charge du HTML depuis un fichier, une URL, une chaîne ou un flux et donne accès au document par l’intermédiaire d’un DOM conforme aux standards. Les applications peuvent rechercher et modifier des éléments, travailler avec CSS, SVG et HTML Canvas, puis utiliser la classe Converter pour créer des fichiers PDF, XPS, DOCX et des images matricielles. L’API prend également en charge XHTML, MHTML, EPUB et Markdown.

Choisissez une tâche pour travailler avec le HTML

Choisissez la tâche correspondant à votre application. Chaque guide présente les classes d’API concernées, fournit un exemple C# ciblé et renvoie vers la documentation détaillée et les pages de référence de l’API.

Créer et charger des documents HTML
Créez des documents à partir de balisage ou de nœuds DOM et chargez du HTML depuis un fichier, une URL, une chaîne ou un flux.

Rechercher et extraire des éléments HTML
Localisez du contenu avec des sélecteurs CSS ou des requêtes XPath et lisez les nœuds DOM correspondants en C#.

Modifier des documents web
Modifiez des éléments, attributs, textes, styles et ressources liées dans les traitements HTML, MHTML et Markdown.

Convertir le HTML vers des formats de sortie
Convertissez HTML et XHTML en PDF, XPS, DOCX, TIFF, PNG, JPEG et autres formats pris en charge.

Convertir EPUB, MHTML, Markdown et SVG
Utilisez les méthodes de conversion et les options d’enregistrement adaptées à chaque format web ou de publication.

Fusionner des documents web
Combinez plusieurs sources HTML, MHTML, EPUB ou Markdown dans un même document en respectant l’ordre requis.

Générer du code HTML
Créez du balisage pour les formulaires, médias, tableaux, liens, éléments interactifs et textes sémantiques dans des exemples en ligne.

newVérifier l’accessibilité web
Vérifiez les règles WCAG, le contraste des couleurs et les textes alternatifs des images, puis exportez les résultats de validation.

Gérer les images dans le HTML
Ajoutez, supprimez, redimensionnez ou extrayez des images tout en conservant la structure et le reste du contenu du document.

Créer et modifier des tableaux HTML
Créez des tableaux avec l’API DOM, extrayez des lignes et cellules ou mettez à jour le contenu de tableaux existants en C#.

Renseigner des modèles HTML
Associez un modèle HTML à des données XML ou JSON pour générer des documents à partir de mises en page réutilisables.

Dessiner avec HTML Canvas 2D
Dessinez des formes, du texte, des tracés et des images avec l’API Canvas 2D, puis effectuez le rendu du résultat avec le document.

Convertir les unités de longueur CSS
Utilisez l’API `Unit` pour convertir les pixels CSS, centimètres et millimètres dans des calculs C#.

newUtiliser le dessin multiplateforme sous Linux
Ajoutez le package Aspose.HTML.Drawing lorsqu’une application Linux nécessite des fonctions de dessin sans System.Drawing.Common.

Installer Aspose.HTML for .NET

Ajoutez le package NuGet Aspose.HTML à un projet .NET. Ce package fournit les espaces de noms nécessaires au DOM HTML, à CSS, au rendu, à la conversion et au traitement de documents utilisés dans les exemples et guides de ce site.

Installer Aspose.HTML avec la CLI .NET



dotnet add package Aspose.HTML

Comment trouver des éléments HTML en C#

Chargez un fichier HTML avec HTMLDocument , utilisez QuerySelectorAll() pour rechercher les éléments correspondants et lisez chaque résultat dans le DOM. L’exemple utilise des types Aspose.HTML explicites et peut être exécuté dans une application console après l’installation du package NuGet.

Rechercher des éléments HTML en C#



using Aspose.Html;
using Aspose.Html.Collections;
using Aspose.Html.Dom;

// Load the HTML document
using HTMLDocument document = new HTMLDocument("input.html");

// Select every link in the document
NodeList links = document.QuerySelectorAll("a");

foreach (Element link in links)
{
    Console.WriteLine($"{link.TextContent}: {link.GetAttribute("href")}");
}

QuerySelectorAll("a") renvoie une NodeList contenant tous les éléments <a> correspondants dans l’ordre du document. Utilisez QuerySelector() lorsque seul le premier élément est requis, ou les requêtes XPath pour les expressions XPath.

Formats web et types de sortie pris en charge

Type d’entrée ou de document	Opérations disponibles
HTML et XHTML	Analyser, créer, modifier, parcourir, fusionner, convertir et effectuer le rendu
MHTML et MHT	Charger, convertir, rendre et fusionner des archives, puis créer des archives actualisées
EPUB	Charger des publications, fusionner du contenu et effectuer le rendu vers des formats à mise en page fixe ou des images
Markdown	Analyser, créer, modifier, convertir en HTML et effectuer le rendu au moyen d’un document HTML
SVG	Charger, inspecter, modifier et convertir du contenu vectoriel

Selon le format source, les traitements de conversion peuvent produire des fichiers PDF, XPS, DOCX, TIFF, PNG, JPEG, BMP et GIF. Consultez la documentation sur la conversion entre formats pour choisir la méthode appropriée de la classe Converter et la classe d’options d’enregistrement correspondante.

Classes de l’API HTML et ressources pour développeurs

HTMLDocument représente un document HTML chargé ou nouvellement créé et permet d’accéder au DOM.
QuerySelector() et QuerySelectorAll() localisent des éléments avec des sélecteurs CSS.
Converter fournit des méthodes statiques pour convertir HTML, XHTML, MHTML, EPUB, Markdown et SVG.
PdfSaveOptions , DocSaveOptions, ImageSaveOptions et XpsSaveOptions configurent la sortie propre à chaque format.

Commencez par la documentation sur l’installation et la configuration , consultez la référence complète de l’API Aspose.HTML for .NET ou testez les exemples exécutables du dépôt GitHub Aspose.HTML for .NET .

Questions fréquentes

1. Que puis-je faire avec un document HTML en C# après son chargement ?

Après avoir chargé du HTML dans un HTMLDocument, vous pouvez inspecter le DOM, rechercher des éléments avec des sélecteurs CSS ou XPath, modifier le contenu et les attributs, ajouter ou supprimer des nœuds, puis enregistrer ou convertir le document mis à jour.

2. Puis-je modifier le HTML avant de le convertir en PDF ou en image ?

Oui. Chargez la source dans un HTMLDocument, modifiez le DOM, les styles CSS ou le contenu lié, puis transmettez le document mis à jour à la méthode de conversion requise. Le fichier PDF, XPS, DOCX ou image généré reflète ces modifications.

3. Comment les URL relatives des fichiers CSS, images et polices sont-elles résolues lors du chargement du HTML ?

Les URL relatives des ressources sont résolues par rapport à l’adresse du document ou à l’URL de base indiquée lors du chargement du HTML. Une URL de base correcte est particulièrement importante lorsque le balisage provient d’une chaîne ou d’un flux et référence des ressources externes.

4. Quelle méthode d’API utiliser pour convertir HTML, MHTML, EPUB, Markdown ou SVG ?

Utilisez la méthode de la classe Converter correspondant au format source, par exemple ConvertHTML(), ConvertMHTML(), ConvertEPUB(), ConvertMarkdown() ou ConvertSVG(). La classe d’options d’enregistrement choisie détermine le format de sortie et les paramètres de conversion.