Конвертация HTML через ActiveX — встройте конвертацию HTML в своё приложение

Вашему веб-приложению нужно превратить HTML-страницу в PDF, DOC или TIFF на сервере. Очевидные варианты болезненны: headless-браузер съедает ОЗУ и падает под нагрузкой, процесс командной строки медленно стартует и его трудно мониторить, облачный API сливает ваши данные и берёт плату за каждый вызов.

Total HTML Converter X предоставляет полный интерфейс ActiveX / COM. Создайте объект один раз из .NET, PHP, Python, ASP, VBScript или любой COM-совместимой среды, вызовите Convert(), получите выходной файл. Никаких подпроцессов, никакого браузерного рендеринга, никакого внешнего API. Файлы не покидают ваш сервер.

Что даёт интерфейс ActiveX

• Конвертация внутри процесса. Конвертер работает в адресном пространстве вашего приложения. Никакого Process.Start(), разбора stdout или процессов-зомби.
• Много форматов одним вызовом. PDF, DOC, DOCX, XLS, TIFF, JPEG, RTF, TXT, XHTML, EMF — формат передаётся параметром.
• Полный рендеринг CSS. Стили CSS 1 и CSS 2, встроенные изображения, таблицы и веб-шрифты отрисовываются собственным движком конвертера — зависимость от браузера не нужна.
• Встроенная защита PDF. Пароли владельца и пользователя, ограничения копирования и печати, водяные знаки, цифровые подписи — задаются параметрами метода.
• Обработка ошибок через HRESULT. COM-исключения превращаются в нативные ошибки языка (исключение .NET, PHP COMException, исключение Python win32). Разбор логов не нужен.
• Одна лицензия, без ограничения пользователей. Установите на одном сервере и обслуживайте конвертацию для всех пользователей вашего приложения.

(30-дневная пробная версия — email не требуется)

Серверная лицензия от $249.90

Что такое ActiveX / COM на самом деле

ActiveX — это компонентная модель от Microsoft. На практике это означает, что Total HTML Converter X регистрирует в Windows COM-класс (HTMLConverter.HTMLConverterX), который может создать и вызвать любая COM-совместимая среда. Вы не обращаетесь к REST API и не запускаете процесс командной строки — вы загружаете DLL в ваше приложение и вызываете методы на объекте, работающем внутри процесса.

Это важно по трём причинам:

• Скорость. Нет запуска процесса, нет IPC, нет сокета. Конвертер — это DLL, загруженная один раз.
• Надёжность. Нет осиротевших процессов, нет PID-файлов, нет разбора логов. Если вызов не удался, ваш язык бросает исключение с HRESULT.
• Безопасность. Никаких файлов, передаваемых по сети. Нет общего временного каталога. Конвертация происходит в памяти или в рабочем каталоге вашего процесса.

Подходит любой язык, понимающий COM: C# и VB.NET через .NET interop, C++ через CoCreateInstance, PHP через класс COM, Python через pywin32, Classic ASP через Server.CreateObject, VBScript, JScript/WSH, Delphi, PowerShell, Ruby через win32ole и Node.js через winax.

Как интегрировать Total HTML Converter X

• Шаг 1. Установите Total HTML Converter X на машине Windows, где работает ваше приложение. Установщик регистрирует COM-класс автоматически.
• Шаг 2. Проверьте регистрацию. В командной строке с правами администратора выполните reg query HKCR\HTMLConverter.HTMLConverterX. Если ключ существует, COM-объект готов.
• Шаг 3. Подключите COM-объект к вашему проекту. В .NET добавьте COM-ссылку или используйте Type.GetTypeFromProgID(). В PHP используйте new COM("HTMLConverter.HTMLConverterX"). В Python — win32com.client.Dispatch("HTMLConverter.HTMLConverterX").
• Шаг 4. Вызовите Convert(source, destination, options). Передайте путь к входному HTML, путь к выходному файлу и строку опций с флагами вроде -c PDF, -OwnerPassword secret, -Watermark CONFIDENTIAL.
• Шаг 5. Обработайте возвращённое значение или исключение. При успехе создаётся выходной файл. При ошибке COM-вызов бросает нативное исключение языка с HRESULT и текстом ошибки.
• Шаг 6. Разверните. Для ASP.NET или IIS убедитесь, что учётная запись пула приложений имеет права на чтение исходного HTML, запись в выходной путь и доступ к реестру COM. Для Python или PHP те же права нужны пользователю, запускающему скрипт.

Примеры кода

C# / .NET

var conv = Activator.CreateInstance(
    Type.GetTypeFromProgID("HTMLConverter.HTMLConverterX"));
conv.GetType().InvokeMember("Convert",
    System.Reflection.BindingFlags.InvokeMethod, null, conv,
    new object[] { @"C:\In\report.html", @"C:\Out\report.pdf",
                   "-c PDF -OwnerPassword s3cret -NoPrint" });

PHP

$c = new COM("HTMLConverter.HTMLConverterX");
$c->Convert(
    "C:\\In\\report.html",
    "C:\\Out\\report.pdf",
    "-c PDF -Watermark DRAFT -log C:\\Logs\\html.log"
);

Python (pywin32)

import win32com.client
conv = win32com.client.Dispatch("HTMLConverter.HTMLConverterX")
conv.Convert(
    r"C:\In\report.html",
    r"C:\Out\report.pdf",
    "-c PDF -OwnerPassword secret -NoPrint"
)

Classic ASP / VBScript

Set Conv = Server.CreateObject("HTMLConverter.HTMLConverterX")
Conv.Convert _
    "C:\In\report.html", _
    "C:\Out\report.pdf", _
    "-c PDF -Watermark ""COMPANY CONFIDENTIAL"""
Set Conv = Nothing

Параметры выходного формата

Третий аргумент метода Convert() — строка флагов, разделённых пробелами. Ключевой флаг — -c FORMAT. Меняете его — меняете выходной формат:

Можно комбинировать с флагами безопасности и макета:

• -OwnerPassword secret — пароль владельца PDF (управляет разрешениями)
• -UserPassword open123 — пароль открытия PDF
• -NoPrint / -NoCopy / -NoModify — ограничения разрешений PDF
• -Watermark "CONFIDENTIAL" — наносит текст водяного знака на каждую страницу
• -PageSize A4 / Letter / Legal — размер бумаги
• -log C:\Logs\html.log — пишет лог конвертации для мониторинга

ActiveX, командная строка и headless-браузер

Когда использовать интеграцию через ActiveX

1. Высоконагруженные веб-приложения. Сайт на ASP.NET или Classic ASP конвертирует в PDF превью HTML-писем, счета или выписки по каждому запросу. ActiveX снимает накладные расходы на запуск процесса — каждая конвертация это вызов метода, а не подпроцесс.
2. Кастомные документные процессы. Служба Windows забирает HTML-файлы из отслеживаемой папки, конвертирует их в PDF с корпоративными водяными знаками и кладёт результат в систему документооборота. Служба сама держит COM-объект; никаких shell-вызовов и bat-файлов.
3. Multi-tenant SaaS-бэкенды. Каждый клиент отправляет HTML-шаблоны, требующие конвертации. Интерфейс ActiveX позволяет бэкенду ставить в очередь и обрабатывать конвертации той же моделью параллелизма, что и остальной конвейер.
4. Изолированные окружения. On-premise развёртывания, где облачные API конвертации заблокированы или запрещены. Компонент ActiveX работает целиком внутри периметра сети.
5. Существующие COM-архитектуры. Унаследованные приложения на Classic ASP, VB6 или C++ с COM уже умеют работать с ActiveX-компонентами. Total HTML Converter X подключается так же.
6. Замена headless-браузерных конвейеров. Команды, уходящие от Puppeteer или PhantomJS из-за давления на память, частых обновлений или сбоев, переходят на ActiveX ради предсказуемого потребления ресурсов.

Почему Total HTML Converter X

Создан для серверов

Никакого GUI, никаких диалогов подтверждения, никаких запросов "Сохранить как". Работает под IIS, внутри служб Windows или из планировщика задач, когда ни один пользователь не вошёл в систему.

Собственный движок рендеринга

Браузер не нужен. Конвертер разбирает HTML и CSS своим кодом. Это значит — обновления Chrome не ломают ваш конвейер, нет браузерных профилей, нет несовпадения версий драйверов.

Одна лицензия на сервер

В отличие от моделей оплаты за пользователя или за конвертацию, Total HTML Converter X лицензируется по серверу. Обслуживайте тысячи пользователей с одной лицензии.

В комплекте с примерами проектов

Установщик поставляется с рабочими проектами-примерами на ASP, PHP и C++. Откройте их в Visual Studio, любой IDE или текстовом редакторе и адаптируйте под свои задачи.

30-дневная пробная версия, без ограничений

Без водяного знака, без лимита на конвертации, email для скачивания не нужен. Встройте конвертер в прототип, убедитесь, что он работает, потом лицензируйте.

(30-дневная пробная версия — email не требуется)

Серверная лицензия от $249.90

Конвертер HTML-файлов для серверов Отзывы клиентов 2026

"Заменили конвейер на Puppeteer, который потреблял 2 ГБ ОЗУ на воркер и падал каждую ночь. Вызов ActiveX встроился в нашу рабочую службу .NET — один вызов метода, никаких подпроцессов, никакого headless-браузера для перезапуска. Память держится ровно. Качество PDF лучше, чем давал нам Chromium, особенно на CSS с таблицами."

Daniel Park Senior Backend Engineer

"Мы крутим под IIS биллинговый портал на PHP. Счета генерируются как HTML-шаблоны, конвертируются в PDF на лету и уходят клиентам по email. Интеграция COM — три строки PHP. Без облачного API, без выхода файлов с нашего сервера. Разовая лицензия за $249.90 окупилась за первую неделю по сравнению с per-document API, который мы рассматривали."

Amira Hassan Web Applications Developer

"Интегрировал с Classic ASP-приложением, которое работает более 15 лет. <code>Server.CreateObject("HTMLConverter.HTMLConverterX")</code> сработал с первого раза под IIS. Хорошо, что 32-битная и 64-битная регистрации раздельны &mdash; мне нужна была 32-битная сборка. Документации не помешало бы больше примеров именно под VB6, но ASP-пример был достаточно близко, чтобы адаптировать."

Victor Rossi IT Integration Lead

FAQ ▼