Aspose.Cells Convertidor HTML per a .NET

Aspose.Cells HTML Converter for .NET enables seamless, high-fidelity conversion between Excel workbooks (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) and HTML/MHTML documents. It exposes a focused API tailored for HTML export and import, ensuring quick integration into any .NET application that requires rendering or embedding spreadsheet content on the web.

Instal·lació i instal·lació

Per començar, afegeix el Aspose.Cells for .NET paquet NuGet al teu projecte. Consulta els passos detallats a la Instal·lació pàgina.

Per a la llicència, aquest connector utilitza metered licensing com Aspose.Cells; consulta el Llicència basada en consum guia per a detalls de configuració.

Característiques i funcionalitats

Formats compatibles

• Excel a HTML: Convertir fitxers Excel (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) a HTML o MHTML compatibles amb els estàndards. • HTML a Excel: Importar HTML/MHTML de nou a llibres de treball d’Excel per a una edició d’anada i tornada.

Conversions de fidelitat

Processament per lots automatitzat amb sortida organitzada.

Informes multi‑fulla amb nomenclatura seqüencial

• Atributs de cel·la personalitzats: Afegeix atributs HTML personalitzats a les cel·les per a una interactivitat millorada i vinculació de dades. • Exportació selectiva de fulls: Exporta fulls de treball específics en lloc del llibre de treball complet. • Control del format d’exportació: Genera documents HTML complets o fragments per incrustar. • Control de paginació: Gestiona llibres de treball amb múltiples fulls amb navegació personalitzada. • Gestió de recursos: Configura recursos en línia o externs (imatges, tipografies, CSS).

Sistemes d’arxiu que requereixen una nomenclatura de fitxers estructurada

• Suport de flux de memòria: Convertiu directament a fluxos de memòria per al processament en memòria. • E/S eficient: Les API basades en fluxos minimitzen la petjada de memòria. • Integració d’aplicacions web: Genera HTML sense problemes cap als fluxos de resposta HTTP.

Desglossament de funcions: Selecció del format d’imatge

Especifiqueu el format de sortida desitjat per a les vostres imatges:.

Desglossament de funcions: Personalització de l’índex de fulls

Controleu com es numeren els fulls en els fitxers de sortida:.

Desglossament de funcions: Personalització de l’índex de les parts dividides

Gestioneu fulls de càlcul grans que es divideixen en diverses pàgines:.

API tradicional: Control granular

Per a un control màxim sobre les opcions de renderització, utilitzeu l’API tradicional SheetRender:.

Exemples d’ús

• Utilitzeu l’API LowCode: Aprofiteu ImageConverter.Process() per a conversions més simples i ràpides. • Memòria cau: Emmagatzemeu a la memòria cau les plantilles utilitzades freqüentment per a conversions repetides. • Mode d’streaming: Utilitzeu streaming per a conversions d’alta DPI de llibres de treball grans. • Alliberament correcte: Allibereu els objectes de llibre de treball i flux de manera immediata per alliberar memòria.

Organització de fitxers:

using Aspose.Cells.LowCode;
using Aspose.Cells;

string src = "template.xlsx";
HtmlConverter.Process(src, "PluginHtml1.html");

• Nom de marcadors de posició: Utilitzeu LowCodeSaveOptionsProviderOfPlaceHolders per a una organització sistemàtica dels fitxers. • Prefixos coherents: Apliqueu prefixos significatius (p. ex., “Invoice”, “Report”) per a una identificació fàcil. • Gestió de desplaçaments: Utilitzeu indexació basada en 1 (SheetIndexOffset = 1) per a noms de fitxer amigables.

Control de qualitat:

using Aspose.Cells.LowCode;
using Aspose.Cells;
using System.IO;
using System.Text;

string src = "template.xlsx";

// Configure load options
LowCodeLoadOptions lclopts = new LowCodeLoadOptions();
lclopts.InputFile = src;

// Configure HTML save options
LowCodeHtmlSaveOptions lcsopts = new LowCodeHtmlSaveOptions();
HtmlSaveOptions htmlOpts = new HtmlSaveOptions();

// Add custom attribute to cells for data binding or JavaScript interaction
htmlOpts.CellNameAttribute = "SpecAddress";

// Export only the first worksheet (index 0)
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0 });

lcsopts.HtmlOptions = htmlOpts;

// Output to memory stream for in-memory processing
MemoryStream ms = new MemoryStream();
lcsopts.OutputStream = ms;

// Perform conversion
HtmlConverter.Process(lclopts, lcsopts);

// Verify custom attribute in output
string htmlContent = Encoding.ASCII.GetString(ms.ToArray());
Console.WriteLine(htmlContent.IndexOf("SpecAddress=\"B2\"") > 0 
    ? "Specified attribute has been output" 
    : "Cannot find the expected attribute");

• Selecció de format: Trieu PNG per a transparència, JPEG per a fitxers més petits, TIFF per a arxiu. • Configuració de resolució: Establiu valors DPI adequats a ImageOrPrintOptions per a impressió vs. ús web. • Verificació de tipografies: Verifiqueu la disponibilitat de tipografies per evitar substitucions silencioses. • Validació de sortida: Comproveu sempre l’existència del fitxer després de la conversió amb File.Exists().

• Inicialitzar una sola vegada: Inicialitzeu la llicència una sola vegada a l’inici per evitar comprovacions repetides. • Definir àrees d’impressió: Establiu àrees d’impressió i configuració de pàgina en plantilles d’Excel per a coherència. • Instàncies agrupades: Utilitzeu instàncies agrupades per al renderitzat del costat del servidor per reduir la càrrega. • Registre d’errors: Implementeu una gestió d’errors i registre complet per a diagnòstics.:

HtmlSaveOptions htmlOpts = new HtmlSaveOptions();
htmlOpts.CellNameAttribute = "data-cell"; // Cells will have data-cell="A1", data-cell="B2", etc.

Preguntes freqüents:

• Què és el Convertidor d’Imatges Aspose.Cells per a .NET? Una eina enfocada per convertir programàticament fulls de càlcul Excel en imatges dins d’aplicacions .NET.
• Com es diferencia de Aspose.Cells per a .NET? Aspose.Cells per a .NET és una API completa, mentre que el connector Convertidor d’Imatges està dissenyat per a una conversió d’imatges ràpida i precisa amb APIs simplificades.
• Quins formats de fitxer són compatibles? Compatibles amb XLS, XLSX, XLSM, XLTX, XLTM, XLSB, CSV, TSV, HTML, ODS i més.
• Puc personalitzar la generació d’imatges? Sí, utilitzant la classe ImageOrPrintOptions per definir el tipus de sortida, la resolució, la compressió i més.

Com puc convertir diverses fulles en imatges separades? Utilitzeu LowCodeSaveOptionsProviderOfPlaceHolders amb patrons de marcadors de posició per generar automàticament noms de fitxer únics per a cada full.

Què signifiquen els marcadors de posició?:

// Export only the first sheet (index 0)
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0 });

// Export multiple specific sheets
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0, 2, 4 });

Preguntes freqüents:

• ${SheetIndexPrefix}: Prefix personalitzat per a fulls (p. ex., “S”, “Sheet”)
• ${SplitPartIndex}: Número de pàgina per a fulls de treball grans dividits en diverses imatges
• Puc començar la numeració dels fulls des de 1 en lloc de 0? Sí, estableix SheetIndexOffset = 1 per utilitzar una indexació basada en 1.

ImageConverter: Classe estàtica que proporciona mètodes de conversió simplificats

LowCodeImageSaveOptions: Configuració per a la sortida d’imatges:

MemoryStream ms = new MemoryStream();
lcsopts.OutputStream = ms;
HtmlConverter.Process(lclopts, lcsopts);

// Use the stream content
byte[] htmlBytes = ms.ToArray();
string htmlString = Encoding.UTF8.GetString(htmlBytes);

Preguntes freqüents:

• LowCodeSaveOptionsProviderOfPlaceHolders: Nomenclatura dinàmica d’arxius amb marcadors de posició
• ImageOptions: Opcions de renderització específiques d’imatge
• ImageType: Format de sortida (PNG, JPEG, TIFF, BMP, EMF, GIF)
• SheetIndexOffset: Número d’inici per a la indexació de fulls

SheetIndexPrefix: Cadena de prefix per als números de fulla

SplitPartIndexOffset: Número d’inici per a la indexació de pàgines/particions:

using Aspose.Cells;

Workbook workbook = new Workbook("Workbook.xlsx");

HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.ExportGridLines = true;
saveOptions.ExportImagesAsBase64 = true;
saveOptions.PresentationPreference = true;

workbook.Save("out.html", saveOptions);

Consells i bones pràctiques

Optimització del rendiment

• Exportació selectiva: Utilitzeu SheetSet per exportar només els fulls de càlcul necessaris i reduir el temps de processament. • API basades en flux: Aprofita els fluxos de memòria en aplicacions web per minimitzar el disk I/O. • Valida l’entrada: Comproveu la mida i la complexitat del full de càlcul abans de la conversió per evitar colls d’ampolla de rendiment.

${SheetIndexPrefix}: Prefix de full personalitzat

• Atributs personalitzats: Utilitzeu CellNameAttribute per a una millor integració de JavaScript i manipulació del DOM. • Gestió de recursos: Configureu recursos en línia vs. externs segons l’escenari de desplegament. • Opcions de afinament: Aprofiteu HtmlSaveOptions per controlar les línies de graella, les fórmules i la gestió d’imatges.

Gestió de memòria

• Alliberar Recursos: Sempre envolta les operacions de conversió en using bloqueja per alliberar recursos ràpidament. • Reutilització de flux: Restableix i reutilitza els streams de memòria per a conversions per lots per reduir la pressió del GC.

Configureu la llicència per consum abans d’utilitzar les API: vegeu Llicència per consum.

• Gestió d’errors: Implementa blocs try-catch i registra avisos de conversió per a l’assegurament de la qualitat. • Processament per lots: Aplica patrons productor-consumidor per a conversions d’alt volum. • Estratègia de memòria cau: Emmagatzema en memòria cau el HTML generat de manera intel·ligent en aplicacions web dinàmiques. • Verificació de la sortida: Valida que la sortida HTML contingui el contingut esperat mitjançant cerques de cadenes o analitzadors HTML.

Cobertura de formats

Admet XLS, XLSX, XLSM, XLTX, XLTM, XLSB.

Conserva fórmules, estils, regions combinades i metadades del llibre de treball.

• HtmlConverter: Classe estàtica que proporciona mètodes de conversió simplificats
• LowCodeLoadOptions: Configuració per a la càrrega de fitxers Excel
• LowCodeHtmlSaveOptions: Configuració per a la sortida HTML
• HtmlSaveOptions: Configuració detallada de la conversió HTML
• SheetSet: Especifica quins fulls de càlcul exportar

Fes coincidir les sortides JSON amb els contractes d’API REST o els esquemes existents.

• CellNameAttribute: Nom d’atribut HTML personalitzat per a l’adreçament de cel·les
• SheetSet: Matriu d’índexs de fulls de càlcul a exportar
• OutputStream: Flux de destinació per a la sortida HTML
• InputFile: Ruta del fitxer Excel d’origen