Створення HTML-документа за допомогою .NET API

Aspose.HTML for .NET створює новий HTMLDocument із деревом HTML-документа, яке застосунок може наповнити через DOM API. Створіть елементи, задайте їхній текст і атрибути, додайте їх до документа й викличте Save(), щоб записати готовий HTML-файл.


Створення та збереження HTML-файлу в C#

У наступному прикладі створюється документ, задається його заголовок, до елемента <body> додаються заголовок сторінки, абзац і посилання, а результат зберігається як created.html.

Код C# для створення 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");

Як створити HTML-файл у C#

  1. Створіть екземпляр HTMLDocument без джерела, щоб отримати новий документ.
  2. Задайте дані рівня документа, наприклад заголовок сторінки через Title.
  3. Створіть потрібні вузли методом CreateElement() , а потім задайте їхній текст, властивості й атрибути.
  4. Додайте елементи до Body або іншого батьківського вузла за допомогою AppendChild() .
  5. Запишіть готовий документ методом Save() .

Можливості створення HTML-документів

  • Готове дерево документа. Новий HTMLDocument містить структуру документа, зокрема Head і Body, тому код може додавати вміст у потрібне місце.
  • Типізовані HTML-елементи. Метод CreateElement() створює DOM-вузли, які за потреби можна привести до класів HTMLHeadingElement, HTMLParagraphElement і HTMLAnchorElement для доступу до властивостей певного елемента.
  • Кероване додавання тексту й розмітки. Використовуйте TextContent для звичайного тексту. Застосовуйте методи DOM або InnerHTML, лише якщо застосунок свідомо передає розмітку, і перевіряйте розмітку з ненадійних джерел.
  • Налаштування атрибутів і зв’язків. Задавайте посилання, класи, ідентифікатори, адреси ресурсів, метадані та інші дані до додавання вузла в дерево документа.
  • Збереження або подальша обробка. Збережіть документ як HTML, продовжте змінювати його за допомогою DOM-запитів або передайте до процесу перетворення, якщо потрібен PDF, DOCX, XPS чи зображення.

Документація та довідник API зі створення HTML

У посібнику Створення або завантаження HTML-документів наведено приклади створення порожнього документа, побудови з розмітки та вибору базової URL-адреси. Стаття Редагування HTML-документа пояснює створення, вставлення, заміну й видалення DOM-вузлів. Якщо застосунок уже має файл, URL, рядок або потік як джерело, використовуйте сценарій Завантаження HTML у C# .


Установлення Aspose.HTML for .NET

Установіть Aspose.HTML for .NET з NuGet за допомогою .NET CLI:

dotnet add package Aspose.HTML

Також можна скористатися інтерфейсом диспетчера пакетів NuGet або виконати Install-Package Aspose.HTML у консолі диспетчера пакетів. Докладні інструкції наведено в посібнику зі встановлення . Щоб оцінити API без обмежень ознайомлювальної версії, запросіть тимчасову ліцензію .


Запитання про створення HTML-документів

1. Чи можна перетворити новий HTMLDocument, не зберігаючи його спочатку?

Так. Передайте документ у пам’яті до відповідного перевантаження Converter.ConvertHTML() разом із потрібними параметрами збереження та вихідним шляхом або потоком. Зберігати проміжний HTML-файл не потрібно.

2. Чи містить новий HTMLDocument елементи <html>, <head> і <body>?

Так. Конструктор без параметрів створює базову структуру HTML-документа. Додавайте метадані й ресурси рівня документа до Head, а видимий вміст сторінки – до Body.

3. Чи додає CreateElement() новий елемент до документа автоматично?

Ні. CreateElement() створює відокремлений вузол. Викличте AppendChild(), InsertBefore() або інший метод вставлення DOM, щоб розмістити вузол у Head, Body чи наявному елементі.

4. Чи потрібно створювати новий документ, якщо повна HTML-розмітка вже міститься в рядку?

Використовуйте конструктор HTMLDocument, який приймає розмітку й базову URL-адресу. Базова URL-адреса визначає відносні посилання та ресурси, а конструктор аналізує передану розмітку й створює DOM.

5. Чи може створений HTML посилатися на CSS, зображення, скрипти та шрифти?

Так. Створіть відповідні HTML-елементи й задайте URL ресурсів або атрибути. Переконайтеся, що відносні посилання правильні для розташування HTML-файлу та пов’язаних ресурсів.

Пов’язані операції з HTML-документами

Перейдіть до завантаження, редагування, вибору елементів або перетворення HTML.