Aspose.Cells HTML Converter pro .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.
Instalace a nastavení
Pro zahájení přidejte Aspose.Cells for .NET NuGet balíček do vašeho projektu. Podívejte se na podrobné kroky na Instalace stránce.
Pro licencování tento plugin používá měřenou licenci stejně jako Aspose.Cells; viz Měřená licence průvodce pro podrobnosti o konfiguraci.
Funkce a vlastnosti
Podporované formáty
• Excel do HTML: Převést soubory Excel (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) na standardy vyhovující HTML nebo MHTML. • HTML do Excelu: Importovat HTML/MHTML zpět do sešitů Excel pro obousměrné úpravy.
S předponou “Sheet” a posunem 1: ReportSheet1_Page1.png, ReportSheet2_Page1.png
Bez předpony, indexováno od nuly: Output0_0.png, Output1_0.png.
Automatizované dávkové zpracování s uspořádaným výstupem
• Vlastní atributy buněk: Přidat vlastní HTML atributy do buněk pro zvýšenou interaktivitu a vazbu dat. • Selektivní export listů: Exportovat konkrétní listy místo celého sešitu. • Ovládání formátu exportu: Generovat kompletní HTML dokumenty nebo fragmenty pro vložení. • Ovládání stránkování: Zpracovat sešity s více listy s vlastním navigováním. • Zpracování zdrojů: Nastavte vložené nebo externí zdroje (obrázky, fonty, CSS).
Velké pracovní listy rozdělené mezi více souborů s obrázky
• Podpora Memory Stream: Převádějte přímo do memory streamů pro zpracování v paměti. • Efektivní I/O: API založená na streamech minimalizují paměťovou stopu. • Integrace webové aplikace: Bezproblémově výstupujte HTML do HTTP response streamů.
Webové galerie s předvídatelnými URL obrázků
Rozpis funkcí: Výběr formátu obrázku.
Zadejte požadovaný výstupní formát pro vaše obrázky:
Rozpis funkcí: Přizpůsobení indexu listu.
Ovládejte, jak jsou listy číslovány ve výstupních souborech:
Rozpis funkcí: Přizpůsobení indexu rozdělených částí.
Zpracovávejte velké pracovní listy, které se rozdělí na více stránek:
Tradiční API: Jemná kontrola.
Příklady použití
• Použijte LowCode API: Využijte ImageConverter.Process() pro jednodušší, rychlejší konverze. • Caching: Ukládejte často používané šablony pro opakované konverze. • Streaming Mode: Použijte streamování pro konverze s vysokým DPI velkých sešitů. • Dispose Properly: Okamžitě uvolněte objekty sešitu a proudu, aby se uvolnila paměť.
Organizace souborů:
using Aspose.Cells.LowCode;
using Aspose.Cells;
string src = "template.xlsx";
HtmlConverter.Process(src, "PluginHtml1.html");• Placeholder Naming: Použijte LowCodeSaveOptionsProviderOfPlaceHolders pro systematickou organizaci souborů. • Consistent Prefixes: Používejte smysluplné předpony (např. “Invoice”, “Report”) pro snadnou identifikaci. • Offset Management: Používejte indexování od jedné (SheetIndexOffset = 1) pro uživatelsky přívětivé názvy souborů.
Kontrola kvality:
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");• Výběr formátu: Zvolte PNG pro průhlednost, JPEG pro menší soubory, TIFF pro archivaci. • Nastavení rozlišení: Nastavte vhodné hodnoty DPI v ImageOrPrintOptions pro tisk vs. webové použití. • Ověření fontů: Ověřte dostupnost fontů, aby nedocházelo k tichým náhradám. • Validace výstupu: Vždy zkontrolujte existenci souboru po konverzi pomocí File.Exists().
• Inicializovat jednou: Inicializujte licencování jednou při spuštění, aby se předešlo opakovaným kontrolám. • Definovat tiskové oblasti: Nastavte tiskové oblasti a nastavení stránky v šablonách Excel pro konzistenci. • Sdílené instance: Používejte sdílené instance pro serverové vykreslování ke snížení zátěže. • Logování chyb: Implementujte komplexní zpracování chyb a logování pro diagnostiku.:
HtmlSaveOptions htmlOpts = new HtmlSaveOptions();
htmlOpts.CellNameAttribute = "data-cell"; // Cells will have data-cell="A1", data-cell="B2", etc.Co je Aspose.Cells Image Converter pro .NET? Zaměřený nástroj pro programatickou konverzi tabulek Excel na obrázky v aplikacích .NET.:
- Jak se liší od Aspose.Cells pro .NET? Aspose.Cells pro .NET je plnohodnotné API, zatímco plugin Image Converter je přizpůsoben pro rychlou a přesnou konverzi obrázků s zjednodušenými API.
- Jaké souborové formáty jsou podporovány? Podporuje XLS, XLSX, XLSM, XLTX, XLTM, XLSB, CSV, TSV, HTML, ODS a další.
- Mohu přizpůsobit generování obrázků? Ano, pomocí třídy
ImageOrPrintOptionsmůžete definovat typ výstupu, rozlišení, kompresi a další. - Jak převést více listů na samostatné obrázky? Použijte
LowCodeSaveOptionsProviderOfPlaceHolderss vzory zástupných znaků k automatickému vytvoření jedinečných názvů souborů pro každý list.
Co znamenají zástupné symboly?
${SheetIndex}: Aktuální číslo listu:
// 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 });Co je Aspose.Cells Image Converter pro .NET? Zaměřený nástroj pro programatickou konverzi tabulek Excel na obrázky v aplikacích .NET..:
${SplitPartIndex}: Číslo stránky pro velké listy rozdělené do více obrázků- Můžu začít číslování listů od 1 místo 0? Ano, nastavte
SheetIndexOffset = 1pro použití indexování od jedné. ImageConverter: Statická třída poskytující zjednodušené metody konverze
LowCodeImageSaveOptions: Konfigurace výstupu obrázku
ImageOrPrintOptions: Podrobné nastavení vykreslování obrázku:
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);Co je Aspose.Cells Image Converter pro .NET? Zaměřený nástroj pro programatickou konverzi tabulek Excel na obrázky v aplikacích .NET.:
ImageOptions: Možnosti vykreslování specifické pro obrázekImageType: Výstupní formát (PNG, JPEG, TIFF, BMP, EMF, GIF)SheetIndexOffset: Počáteční číslo pro indexování listůSheetIndexPrefix: Předpona pro čísla listů
SplitPartIndexOffset: Počáteční číslo pro indexování stránek/rozdělení
Zástupné tokeny:
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);${SheetIndex}: Index listu (s aplikovaným posunem)
Optimalizace výkonu
• Selektivní export: Použít SheetSet pro export pouze nezbytných listů a snížení doby zpracování. • API založená na streamu: Využijte paměťové streamy ve webových aplikacích k minimalizaci diskového I/O. • Ověřit vstup: Zkontrolujte velikost a složitost listu před konverzí, abyste se vyhnuli úzkým hrdlům výkonu.
Aspose.Cells JSON Converter pro .NET poskytuje plynulou, vysoce výkonnou konverzi mezi sešity Microsoft Excel (XLS, XLSX, XLSM) a datovými strukturami JSON. Ať už potřebujete serializovat obsah listů do JSON pro webové aplikace nebo rekonstruovat soubory Excel z JSON payloadů, tento plugin zajišťuje přesnost, validaci schématu a efektivní výkon.
• Vlastní atributy: Použít CellNameAttribute pro lepší integraci JavaScriptu a manipulaci s DOM. • Správa zdrojů: Nakonfigurujte vložené vs. externí zdroje podle scénáře nasazení. • Možnosti doladění: Využít HtmlSaveOptions k řízení mřížkových čar, vzorců a zpracování obrázků.
Správa paměti
• Uvolnit prostředky: Vždy zabalte operace konverze do using bloků, aby se prostředky uvolnily okamžitě. • Znovupoužití Streamu: Resetujte a znovu použijte paměťové streamy pro hromadné konverze, aby se snížil tlak na GC.
Pokrytí formátů
• Zpracování chyb: Implementujte bloky try-catch a zaznamenávejte varování o konverzi pro zajištění kvality. • Dávkové zpracování: Použijte vzory producent‑spotřebitel pro konverze s vysokým objemem. • Strategie cachování: Inteligentně cachujte generované HTML v dynamických webových aplikacích. • Ověřování výstupu: Ověřte, že výstup HTML obsahuje očekávaný obsah pomocí řetězcových vyhledávání nebo HTML parserů.
Zachovává vzorce, styly, sloučené oblasti a metadata sešitu.
| Problém | Rozlišení |
|---|---|
| Soubor nebyl nalezen | Zkontrolujte přesnost cesty k souboru a zajistěte správné escapování zpětných lomítek ve Windows cestách |
| Nepodporovaný formát souboru | Ujistěte se, že vstupní formát je podporován Aspose.Cells (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) |
| Vlastní atribut se nezobrazuje | Ověřit CellNameAttribute je nastaveno před voláním Process() a zkontrolujte kódování výstupu HTML |
| Přetečení paměti | Použijte selektivní export listů nebo zpracovávejte velké soubory po částech pomocí konverze založené na rozsahu |
| Chybějící obrázky v HTML | Konfigurovat ExportImagesAsBase64 nebo zajistěte, aby externí cesty k obrázkům byly přístupné |
Vlastní mapování JSON schématu
Mapovat rozsahy na pole JSON nebo objekty.
HtmlConverter: Statická třída poskytující zjednodušené konverzní metodyLowCodeLoadOptions: Konfigurace pro načítání souborů ExcelLowCodeHtmlSaveOptions: Konfigurace pro výstup HTMLHtmlSaveOptions: Podrobné nastavení konverze HTMLSheetSet: Určuje, které listy se mají exportovat
Webová integrace: Vypisujte JSON přímo do HTTP odpovědních streamů ve webových aplikacích.
CellNameAttribute: Vlastní název HTML atributu pro adresování buněkSheetSet: Pole indexů listů k exportuOutputStream: Cílový stream pro výstup HTMLInputFile: Cesta ke zdrojovému souboru Excel