API обробки HTML на C# – Aspose.HTML for .NET

Аналізуйте HTML, редагуйте DOM, конвертуйте вебдокументи та створюйте вихідні файли в застосунках .NET.

Аналіз, редагування та конвертація HTML на C#

Aspose.HTML for .NET – бібліотека класів для обробки HTML-вмісту в застосунках C#. Клас HTMLDocument завантажує HTML із файлу, URL-адреси, рядка або потоку й надає доступ до документа через стандартну об’єктну модель документа (DOM). Застосунки можуть знаходити й редагувати елементи, працювати з CSS, SVG та HTML Canvas, а також використовувати клас Converter для створення PDF, XPS, DOCX і растрових зображень. API також підтримує XHTML, MHTML, EPUB і Markdown.

Виберіть завдання для роботи з HTML

Виберіть завдання, що відповідає вашому застосунку. У кожному посібнику описано потрібні класи API, наведено цільовий приклад на C# і додано посилання на докладну документацію та сторінки API Reference.

Створення та завантаження HTML-документів
Створюйте документи з розмітки або вузлів DOM і завантажуйте HTML із файлу, URL-адреси, рядка чи потоку.

Пошук і вилучення HTML-елементів
Знаходьте вміст за допомогою CSS-селекторів або XPath-запитів і читайте відповідні вузли DOM на C#.

Редагування вебдокументів
Змінюйте елементи, атрибути, текст, стилі та пов’язані ресурси в HTML, MHTML і Markdown.

Конвертація HTML в інші формати
Перетворюйте HTML і XHTML у PDF, XPS, DOCX, TIFF, PNG, JPEG та інші підтримувані формати.

Конвертація EPUB, MHTML, Markdown і SVG
Використовуйте методи конвертації та параметри збереження, що відповідають кожному вебформату або формату публікації.

Об’єднання вебдокументів
Об’єднуйте кілька джерел HTML, MHTML, EPUB або Markdown в один документ у потрібному порядку.

Генерація HTML-коду
Створюйте розмітку для форм, мультимедіа, таблиць, посилань, інтерактивних елементів і семантичного тексту в онлайн-прикладах.

newПеревірка вебдоступності
Перевіряйте правила WCAG, колірний контраст і альтернативний текст зображень, а потім експортуйте результати перевірки.

Робота із зображеннями в HTML
Додавайте, видаляйте, змінюйте розміри або вилучайте зображення, зберігаючи структуру та решту вмісту документа.

Створення та редагування HTML-таблиць
Створюйте таблиці через DOM API, вилучайте рядки й комірки або оновлюйте вміст наявних таблиць на C#.

Заповнення HTML-шаблонів
Поєднуйте HTML-шаблон із даними XML або JSON, щоб створювати документи на основі повторно використовуваних макетів.

Малювання за допомогою HTML Canvas 2D
Малюйте фігури, текст, контури й зображення через Canvas 2D API та відображайте результат у документі.

Перетворення одиниць довжини CSS
Використовуйте API `Unit` для перетворення CSS-пікселів, сантиметрів і міліметрів у розрахунках на C#.

newКросплатформне малювання в Linux
Додайте пакет Aspose.HTML.Drawing, якщо застосунку Linux потрібні функції малювання без System.Drawing.Common.

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

Додайте пакет Aspose.HTML із NuGet до проєкту .NET. Пакет надає простори імен для роботи з HTML DOM, CSS, рендерингом, конвертацією та обробкою документів, які використовуються в прикладах і посібниках на цьому сайті.

Установлення Aspose.HTML через .NET CLI



dotnet add package Aspose.HTML

Як знайти HTML-елементи на C#

Завантажте HTML-файл за допомогою HTMLDocument , викличте QuerySelectorAll() для пошуку відповідних елементів і прочитайте кожен результат через DOM. У прикладі використано явні типи Aspose.HTML for .NET. Після встановлення пакета NuGet код можна виконати в консольному застосунку.

Пошук HTML-елементів на 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") повертає NodeList з усіма відповідними елементами <a> у порядку їх розташування в документі. Використовуйте QuerySelector(), якщо потрібен лише перший знайдений елемент, або XPath-запити для виразів XPath.

Підтримувані вебформати та вихідні файли

Вхідний формат або тип документа	Доступні операції
HTML і XHTML	Аналіз, створення, редагування, навігація, об’єднання, конвертація та рендеринг
MHTML і MHT	Завантаження, конвертація, рендеринг і об’єднання архівів, а також створення оновлених архівів
EPUB	Завантаження публікацій, об’єднання вмісту та рендеринг у формати з фіксованою розміткою або зображення
Markdown	Аналіз, створення, редагування, перетворення на HTML і рендеринг через HTML-документ
SVG	Завантаження, перевірка, редагування та конвертація векторного вмісту

Залежно від вихідного формату конвертація може створювати файли PDF, XPS, DOCX, TIFF, PNG, JPEG, BMP і GIF. У статті Converting Between Formats описано, як вибрати метод класу Converter і відповідний клас параметрів збереження.

Класи HTML API та ресурси для розробників

HTMLDocument представляє завантажений або створений HTML-документ і надає доступ до DOM.
QuerySelector() і QuerySelectorAll() знаходять елементи за допомогою CSS-селекторів.
Converter надає статичні методи для конвертації HTML, XHTML, MHTML, EPUB, Markdown і SVG.
PdfSaveOptions , DocSaveOptions, ImageSaveOptions і XpsSaveOptions налаштовують вихідні дані для певного формату.

Почніть із Getting Started , відкрийте повний Aspose.HTML for .NET API Reference або перегляньте готові до виконання приклади в репозиторії Aspose.HTML for .NET на GitHub .

Часті запитання

1. Що можна зробити з HTML-документом на C# після завантаження?

Після завантаження HTML в HTMLDocument можна перевіряти DOM, знаходити елементи за допомогою CSS-селекторів або XPath, змінювати вміст і атрибути, додавати чи видаляти вузли, а потім зберігати або конвертувати оновлений документ.

2. Чи можна змінити HTML перед конвертацією в PDF або зображення?

Так. Завантажте вихідний файл в HTMLDocument, змініть DOM, CSS або пов’язаний вміст і передайте оновлений документ потрібному методу конвертації. Створений PDF, XPS, DOCX або файл зображення міститиме внесені зміни.

3. Як обробляються відносні URL-адреси CSS, зображень і шрифтів під час завантаження HTML?

Відносні URL-адреси ресурсів визначаються відносно адреси документа або базової URL-адреси, зазначеної під час завантаження HTML. Правильна базова URL-адреса особливо важлива, якщо розмітка завантажується з рядка чи потоку та посилається на зовнішні ресурси.

4. Який метод API використовувати для конвертації HTML, MHTML, EPUB, Markdown або SVG?

Використовуйте метод класу Converter, що відповідає вихідному формату, наприклад ConvertHTML(), ConvertMHTML(), ConvertEPUB(), ConvertMarkdown() або ConvertSVG(). Клас параметрів збереження визначає вихідний формат і налаштування конвертації.