Créer des fichiers HTML en C#

Créer un document HTML avec une API .NET

Aspose.HTML for .NET crée un nouvel HTMLDocument contenant une arborescence HTML que l’application peut compléter au moyen de l’API DOM. Créez des éléments, définissez leur texte et leurs attributs, ajoutez-les au document, puis appelez Save() pour écrire le fichier HTML final.

Créer et enregistrer un fichier HTML en C#

L’exemple suivant crée un document, définit son titre, ajoute un titre de page, un paragraphe et un lien à l’élément <body>, puis enregistre le résultat sous created.html.

using Aspose.Html;

using HTMLDocument document = new HTMLDocument();

document.Title = "Product overview";

// Create the visible page elements
HTMLHeadingElement heading =
    (HTMLHeadingElement)document.CreateElement("h1");
heading.TextContent = "Product overview";

HTMLParagraphElement paragraph =
    (HTMLParagraphElement)document.CreateElement("p");
paragraph.TextContent = "Explore the product documentation and examples.";

HTMLAnchorElement link =
    (HTMLAnchorElement)document.CreateElement("a");
link.Href = "https://docs.aspose.com/html/net/";
link.TextContent = "Read the documentation";

// Add the elements in document order
document.Body.AppendChild(heading);
document.Body.AppendChild(paragraph);
document.Body.AppendChild(link);

// Save the completed HTML document
document.Save("created.html");

Étapes pour créer un fichier HTML en C#

1. Instanciez HTMLDocument sans source afin de créer un nouveau document.
2. Définissez les données du document, comme le titre de la page avec Title.
3. Créez les nœuds nécessaires avec CreateElement() , puis définissez leur texte, leurs propriétés et leurs attributs.
4. Ajoutez les éléments à Body ou à un autre nœud parent avec AppendChild() .
5. Écrivez le document terminé avec Save() .

Fonctionnalités de création de documents HTML

• Commencer avec une arborescence de document. Un nouvel HTMLDocument fournit la structure du document, notamment Head et Body, afin que le code ajoute le contenu au bon emplacement.
• Créer des éléments HTML typés. CreateElement() produit des nœuds DOM qui peuvent être convertis en classes telles que HTMLHeadingElement, HTMLParagraphElement et HTMLAnchorElement lorsque leurs propriétés spécifiques sont utiles.
• Ajouter du texte ou du balisage de manière contrôlée. Utilisez TextContent pour le texte brut. Utilisez les méthodes DOM ou InnerHTML uniquement lorsque l’application fournit volontairement du balisage, et validez tout balisage provenant d’une source non fiable.
• Définir les attributs et les relations. Configurez les liens, classes, identifiants, adresses de ressources, métadonnées et autres données avant d’ajouter chaque nœud à l’arborescence.
• Enregistrer ou poursuivre le traitement. Enregistrez le document au format HTML, modifiez-le avec des requêtes DOM ou transmettez-le à un flux de conversion pour obtenir un PDF, DOCX, XPS ou une image.

Documentation et référence API pour créer du HTML

Consultez Créer ou charger des documents HTML pour découvrir la création d’un document vide ou à partir de balisage et le choix d’une URL de base. Le guide Modifier un document HTML explique comment créer, insérer, remplacer et supprimer des nœuds DOM. Si l’application possède déjà un fichier, une URL, une chaîne ou un flux comme source, utilisez plutôt le processus Charger du HTML en C# .

Installer Aspose.HTML for .NET

Installez Aspose.HTML for .NET depuis NuGet avec l’interface CLI .NET :

dotnet add package Aspose.HTML

Vous pouvez également utiliser l’interface du gestionnaire de packages NuGet ou exécuter Install-Package Aspose.HTML dans la console du gestionnaire de packages. Consultez le guide d’installation pour la configuration, ou demandez une licence temporaire afin d’évaluer l’API sans limitations.

Questions fréquentes sur la création de documents HTML

1. Puis-je convertir un nouvel HTMLDocument sans l’enregistrer auparavant?

Oui. Transmettez le document en mémoire à la surcharge appropriée de Converter.ConvertHTML() avec les options d’enregistrement requises et un chemin ou flux de sortie. Aucun fichier HTML intermédiaire n’est nécessaire.

2. Un nouvel HTMLDocument contient-il les éléments <html>, <head> et <body>?

Oui. Le constructeur sans paramètre crée la structure HTML de base. Ajoutez les métadonnées et les ressources du document à Head, et le contenu visible de la page à Body.

3. La méthode CreateElement() ajoute-t-elle automatiquement le nouvel élément au document?

Non. CreateElement() crée un nœud détaché. Appelez AppendChild(), InsertBefore() ou une autre méthode d’insertion DOM pour le placer sous Head, Body ou un élément existant.

4. Dois-je créer un document si le balisage HTML complet existe déjà dans une chaîne?

Utilisez un constructeur HTMLDocument qui accepte le balisage et une URL de base. Cette URL résout les liens et ressources relatifs, tandis que le constructeur analyse le balisage fourni pour créer le DOM.

5. Le HTML généré peut-il référencer des feuilles CSS, images, scripts et polices?

Oui. Créez les éléments HTML correspondants et définissez les URL ou attributs des ressources. Vérifiez que les références relatives sont valides pour l’emplacement de déploiement du fichier HTML et de ses ressources.