Convertire HTML con ActiveX — Integra la conversione HTML nella tua applicazione

La tua applicazione web deve trasformare una pagina HTML in PDF, DOC o TIFF sul server. Le opzioni ovvie sono dolorose: un browser headless divora RAM e va in crash sotto carico, un processo da riga di comando è lento all'avvio e difficile da monitorare, un'API cloud fa uscire i tuoi dati e addebita per ogni chiamata.

Total HTML Converter X espone un'interfaccia ActiveX / COM completa. Istanzia l'oggetto una volta da .NET, PHP, Python, ASP, VBScript o da qualsiasi runtime compatibile con COM, chiama Convert(), ottieni il file di output. Nessun subprocess da avviare, nessun rendering del browser, nessuna API esterna. I file non lasciano mai il tuo server.

Cosa ti offre l'interfaccia ActiveX

• Conversione in-process. Il convertitore gira all'interno dello spazio di processo della tua applicazione. Niente Process.Start(), niente parsing di stdout, niente processi zombie.
• Output multi-formato da una sola chiamata. PDF, DOC, DOCX, XLS, TIFF, JPEG, RTF, TXT, XHTML, EMF — passa il formato come parametro.
• Rendering CSS completo. Stili CSS 1 e CSS 2, immagini inline, tabelle e web font renderizzati dal motore del convertitore stesso — nessuna dipendenza da browser.
• Sicurezza PDF integrata. Password proprietario e utente, restrizioni di copia/stampa, filigrane, firme digitali — impostate come parametri del metodo.
• Gestione errori tramite HRESULT. Le eccezioni COM emergono come errori nativi del linguaggio (eccezione .NET, COMException PHP, eccezione Python win32). Niente parsing di log.
• Licenza singola, utenti illimitati. Installa su un server, fornisci la conversione a ogni utente della tua applicazione.

(prova di 30 giorni — nessuna email richiesta)

La licenza server parte da $249,90

Cos'è davvero ActiveX / COM

ActiveX è un modello di componenti Microsoft. In termini pratici, significa che Total HTML Converter X registra in Windows una classe COM (HTMLConverter.HTMLConverterX) che qualsiasi runtime compatibile con COM può istanziare e richiamare. Non stai chiamando un'API REST o un processo da riga di comando — stai caricando una DLL nella tua applicazione e invocando metodi su un oggetto in-process.

Questo conta per tre motivi:

• Velocità. Niente avvio di processi, niente IPC, niente socket. Il convertitore è una DLL caricata una sola volta.
• Affidabilità. Niente processi orfani, niente file PID, niente scraping di log. Se la chiamata fallisce, il tuo linguaggio solleva un'eccezione con un HRESULT.
• Sicurezza. Nessun file trasmesso sulla rete. Nessuna directory temporanea condivisa. La conversione avviene in memoria o nella directory di lavoro del tuo processo.

Qualsiasi linguaggio che parla COM funziona: C# e VB.NET tramite .NET interop, C++ tramite CoCreateInstance, PHP tramite la classe COM, Python tramite pywin32, Classic ASP tramite Server.CreateObject, VBScript, JScript/WSH, Delphi, PowerShell, Ruby tramite win32ole e Node.js tramite winax.

Come integrare Total HTML Converter X

• Passo 1. Installa Total HTML Converter X sulla macchina Windows dove gira la tua applicazione. L'installer registra automaticamente la classe COM.
• Passo 2. Verifica la registrazione. Da un prompt dei comandi con privilegi elevati, esegui reg query HKCR\HTMLConverter.HTMLConverterX. Se la chiave esiste, l'oggetto COM è pronto.
• Passo 3. Referenzia l'oggetto COM dal tuo progetto. In .NET aggiungi un riferimento COM o usa Type.GetTypeFromProgID(). In PHP usa new COM("HTMLConverter.HTMLConverterX"). In Python usa win32com.client.Dispatch("HTMLConverter.HTMLConverterX").
• Passo 4. Chiama Convert(source, destination, options). Passa il percorso HTML di input, il percorso del file di output e una stringa di opzioni con flag come -c PDF, -OwnerPassword secret, -Watermark CONFIDENTIAL.
• Passo 5. Gestisci il valore di ritorno o l'eccezione. In caso di successo, viene creato il file di output. In caso di fallimento, la chiamata COM solleva un'eccezione nativa del linguaggio con HRESULT e testo dell'errore.
• Passo 6. Distribuisci. Per ASP.NET o IIS, assicurati che l'identità dell'application pool abbia i permessi per leggere l'HTML sorgente, scrivere nel percorso di output e accedere al registro COM. Per Python o PHP, l'utente che esegue lo script necessita degli stessi permessi.

Esempi di codice

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

Opzioni del formato di output

Il terzo argomento di Convert() è una stringa di flag separati da spazi. Il flag chiave è -c FORMAT. Cambialo e cambi l'output:

Puoi combinare con flag di sicurezza e layout:

• -OwnerPassword secret — password proprietario PDF (controlla i permessi)
• -UserPassword open123 — password di apertura PDF
• -NoPrint / -NoCopy / -NoModify — restrizioni dei permessi PDF
• -Watermark "CONFIDENTIAL" — imprime una filigrana di testo su ogni pagina
• -PageSize A4 / Letter / Legal — formato della carta
• -log C:\Logs\html.log — scrive il log della conversione per il monitoraggio

ActiveX vs Riga di comando vs Browser headless

Quando usare l'integrazione ActiveX

1. Applicazioni web ad alto throughput. Un sito ASP.NET o Classic ASP converte in PDF anteprime di email, fatture o estratti conto ad ogni richiesta. ActiveX elimina il sovraccarico dell'avvio di processi — ogni conversione è una chiamata di metodo, non un subprocess.
2. Flussi di lavoro documentali personalizzati. Un servizio Windows preleva i file HTML da una cartella monitorata, li converte in PDF con le filigrane aziendali e deposita i risultati in un sistema di gestione documentale. Il servizio ospita direttamente l'oggetto COM; niente shell-out, niente file batch.
3. Backend SaaS multi-tenant. Ogni tenant invia template HTML che richiedono conversione. L'interfaccia ActiveX permette al tuo backend di accodare ed elaborare conversioni con lo stesso modello di concorrenza del resto della tua pipeline.
4. Ambienti isolati (air-gapped). Distribuzioni on-premises dove le API di conversione cloud sono bloccate o vietate. Il componente ActiveX gira interamente all'interno del perimetro di rete.
5. Architetture COM esistenti. Le applicazioni legacy costruite su Classic ASP, VB6 o C++ con COM sanno già come lavorare con componenti ActiveX. Total HTML Converter X si inserisce allo stesso modo.
6. Sostituire pipeline di browser headless. I team che migrano da Puppeteer o PhantomJS a causa della pressione sulla memoria, della continua rotazione degli aggiornamenti o della frequenza dei crash passano ad ActiveX per un uso delle risorse prevedibile.

Perché Total HTML Converter X

Costruito apposta per i server

Niente GUI, niente finestre di conferma, niente prompt "Salva con nome". Gira sotto IIS, all'interno di servizi Windows o da attività pianificate senza alcun utente collegato.

Motore di rendering proprio

Nessun browser richiesto. Il convertitore analizza HTML e CSS con codice proprio. Questo significa niente aggiornamenti di Chrome che rompono la tua pipeline, niente profili browser, niente incompatibilità di versione tra driver.

Licenza singola per server

A differenza dei prezzi per utente o per conversione, Total HTML Converter X è in licenza per server. Servi migliaia di utenti da una sola licenza.

Progetti di esempio inclusi

L'installer include progetti di esempio funzionanti in ASP, PHP e C++. Aprili in Visual Studio, in un IDE a tua scelta o in un editor di testo e adattali alle tue esigenze.

Prova di 30 giorni, pienamente funzionante

Nessuna filigrana, nessun limite di conversione, nessuna email richiesta per il download. Integralo nel tuo prototipo, dimostra che funziona, poi concedilo in licenza.

(prova di 30 giorni — nessuna email richiesta)

La licenza server parte da $249,90

Convertitore di file HTML per server Recensioni dei clienti 2026

"Ho sostituito una pipeline Puppeteer che consumava 2 GB di RAM per worker e andava in crash ogni notte. La chiamata ActiveX si inserisce nel nostro servizio worker .NET esistente — una chiamata di metodo, nessun subprocess, nessun browser headless da riavviare. La memoria resta stabile. La qualità dell'output PDF è migliore di quella che ci dava Chromium, soprattutto su CSS con tabelle."

Daniel Park Senior Backend Engineer

"Gestiamo un portale di fatturazione PHP sotto IIS. Le fatture vengono generate come template HTML, convertite al volo in PDF e inviate via email ai clienti. L'integrazione COM sono tre righe di PHP. Nessuna API cloud, nessun file che esce dal nostro server. La licenza una tantum da $249,90 si è ripagata nella prima settimana d'uso rispetto all'API per-documento che stavamo valutando."

Amira Hassan Web Applications Developer

"Integrato con un'applicazione Classic ASP che gira da oltre 15 anni. <code>Server.CreateObject("HTMLConverter.HTMLConverterX")</code> ha funzionato al primo tentativo sotto IIS. Ottimo che le registrazioni a 32 bit e 64 bit siano separate &mdash; mi serviva la build a 32 bit. La documentazione potrebbe avere pi&ugrave; esempi specifici per VB6, ma l'esempio ASP era abbastanza vicino da adattarsi."

Victor Rossi IT Integration Lead

FAQ ▼