通过ActiveX转换HTML — 将HTML转换功能嵌入您的应用程序

您的Web应用程序需要在服务器上将HTML页面转换为PDF、DOC或TIFF。常见的选择都不理想：无头浏览器消耗大量内存并在高负载下崩溃，命令行进程启动慢且难以监控，云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样式、内联图像、表格和Web字体由转换器自带的引擎渲染 — 无需依赖浏览器。
• 内置PDF安全性。所有者密码和用户密码、复制/打印限制、水印、数字签名 — 均作为方法参数设置。
• 通过HRESULT进行错误处理。COM异常以语言原生错误的形式呈现（.NET异常、PHP COMException、Python win32异常）。无需解析日志。
• 单一许可证，用户数量不限。在一台服务器上安装，即可为应用程序的每个用户提供转换服务。

（30天试用期 — 无需提供邮箱）

服务器许可证起价$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互操作、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与命令行与无头浏览器的对比

何时使用ActiveX集成

1. 高吞吐量的Web应用程序。ASP.NET或Classic ASP站点在每次请求时将HTML邮件预览、发票或对账单转换为PDF。ActiveX消除了进程派生开销 — 每次转换是一次方法调用，而不是子进程。
2. 自定义文档工作流程。Windows服务从监视文件夹中获取HTML文件，将其转换为带公司水印的PDF，并将结果放入文档管理系统。该服务直接承载COM对象；无需shell调用，无需批处理文件。
3. 多租户SaaS后端。每个租户提交需要转换的HTML模板。ActiveX接口让您的后端能够按照与其他流水线相同的并发模型对转换进行排队和处理。
4. 隔离网络环境。云转换API被阻止或禁止的本地部署。ActiveX组件完全在网络边界内运行。
5. 现有的基于COM的架构。基于Classic ASP、VB6或带COM的C++构建的遗留应用程序已经知道如何使用ActiveX组件。Total HTML Converter X以相同的方式接入。
6. 替换无头浏览器流水线。因内存压力、更新频繁或崩溃频发而从Puppeteer或PhantomJS迁移的团队转向ActiveX，以获得可预测的资源使用情况。

为什么选择Total HTML Converter X

专为服务器设计

无GUI，无确认对话框，无"另存为"提示。在IIS下运行、在Windows服务中运行、或在无用户登录的计划任务中运行。

自有渲染引擎

无需浏览器。转换器使用自己的代码解析HTML和CSS。这意味着Chrome更新不会破坏您的流水线，没有浏览器配置文件，没有驱动程序版本不匹配问题。

每台服务器一个许可证

不同于按用户或按次收费，Total HTML Converter X按服务器授权。一个许可证为成千上万的用户提供服务。

附带示例项目

安装程序附带可运行的ASP、PHP和C++示例项目。在Visual Studio、您选择的IDE或文本编辑器中打开它们，根据需要进行调整。

30天试用，功能完整

无水印，无转换次数限制，下载无需提供邮箱。将其集成到您的原型中，证明其有效，然后再购买许可证。

（30天试用期 — 无需提供邮箱）

服务器许可证起价$249.90

HTML 文件批量转换工具（服务器端） 客户评价 2026

"替换了一条每个工作进程消耗2 GB内存且每晚都会崩溃的Puppeteer流水线。ActiveX调用完美融入我们现有的.NET工作服务 — 一次方法调用，无子进程，无需重启无头浏览器。内存保持平稳。PDF输出质量比Chromium给我们的效果更好，特别是在带表格的CSS上。"

Daniel Park Senior Backend Engineer

"我们在IIS下运行一个PHP计费门户。发票以HTML模板形式生成，实时转换为PDF，然后通过邮件发送给客户。COM集成只有三行PHP代码。无需云API，文件不会离开我们的服务器。相比我们评估过的按文档收费的API，$249.90的一次性许可证费用在使用的第一周就收回了成本。"

Amira Hassan Web Applications Developer

"集成到一个已运行15年以上的Classic ASP应用程序中。<code>Server.CreateObject("HTMLConverter.HTMLConverterX")</code>在IIS下第一次就成功了。32位和64位注册是分开的这一点很好 &mdash; 我需要的是32位版本。文档可以为VB6提供更多示例，但ASP示例已经足够接近，可以调整使用。"

Victor Rossi IT Integration Lead

FAQ ▼