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.

Создание и загрузка 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. После установки пакета 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. В документации по конвертации форматов описано, как выбрать метод класса Converter и подходящий класс параметров сохранения.

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

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

Начните с документации по установке и настройке , откройте полный справочник Aspose.HTML for .NET API или изучите готовые примеры кода в репозитории 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(). Класс параметров сохранения определяет выходной формат и настройки конвертации.