Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fei-sheng-wu/xlsxtohtmlconverter
A fast Xlsx to Html file converter. Support cell fills, fonts, borders, alignments, and other styles. Support different cell sizes and merged cells. Support custom number formats and basic conditions. Support multiple sheets and hidden sheets. Support embedded pictures. Support progress callbacks. Only depend on the Microsoft Open Xml SDK.
https://github.com/fei-sheng-wu/xlsxtohtmlconverter
conversion convert converter csharp dotnet excel excel-converter excel-exporter excel-parser excel-to-html html html-creator xlsx xlsx-converter xlsx-exporter xlsx-parser xlsx-to-html
Last synced: about 2 months ago
JSON representation
A fast Xlsx to Html file converter. Support cell fills, fonts, borders, alignments, and other styles. Support different cell sizes and merged cells. Support custom number formats and basic conditions. Support multiple sheets and hidden sheets. Support embedded pictures. Support progress callbacks. Only depend on the Microsoft Open Xml SDK.
- Host: GitHub
- URL: https://github.com/fei-sheng-wu/xlsxtohtmlconverter
- Owner: Fei-Sheng-Wu
- License: mit
- Created: 2020-05-14T04:01:39.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-22T22:30:25.000Z (3 months ago)
- Last Synced: 2024-10-11T14:16:39.589Z (2 months ago)
- Topics: conversion, convert, converter, csharp, dotnet, excel, excel-converter, excel-exporter, excel-parser, excel-to-html, html, html-creator, xlsx, xlsx-converter, xlsx-exporter, xlsx-parser, xlsx-to-html
- Language: C#
- Homepage: https://www.nuget.org/packages/XlsxToHtmlConverter
- Size: 6.15 MB
- Stars: 11
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# XlsxToHtmlConverter v1.2.21-dev
[](https://docs.microsoft.com/en-us/dotnet/csharp/)
[](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
[](https://dotnet.microsoft.com/en-us/platform/dotnet-standard)
[](https://www.nuget.org/packages/XlsxToHtmlConverter/1.2.20)
[](https://github.com/Fei-Sheng-Wu/XlsxToHtmlConverter/blob/master/LICENSE.txt)
> A fast Xlsx to Html file converter. Support cell fills, fonts, borders, alignments, and other styles. Support different cell sizes and merged cells. Support custom number formats and basic conditions. Support multiple sheets and hidden sheets. Support embedded pictures. Support progress callbacks. Only depend on the Microsoft Open Xml SDK.
## Dependencies
**DocumentFormat.OpenXml** ≥ 3.0.0
## Main Features
- [x] Cell fills, fonts, borders, alignments, and other styles
- [x] Custom column widths and row heights
- [x] Vertical and horizontal merged cells
- [x] Number formats and basic conditional formats
- [x] Sheet tab titles, colors, and hidden sheets
- [x] Picture embeddings as Base64 images
- [x] Conversion progress callback
### Original Xlsx File
### Converted Html File
## How to Use
Only one line to convert a Xlsx file to Html with the use of `Stream`.
```c#
XlsxToHtmlConverter.Converter.ConvertXlsx(inputStream, outputStream);
```
Or to convert with specific `ConverterConfig` and progress callback.
```c#
XlsxToHtmlConverter.Converter.ConvertXlsx(inputStream, outputStream, config, progressCallback);
```
### Convert Local Files
Just use a `string` of the path to the file instead of a `Stream` to convert a local Xlsx file.
```c#
string filename = @"C:\path\to\file.xlsx";
XlsxToHtmlConverter.Converter.ConvertXlsx(filename, outputStream);
```
A third optional parameter can be set to decide whether to use a `MemoryStream` or a `FileStream`. When set to `true`, a `MemoryStream` is used to load the entire file at once instead of reading the file with a `FileStream`.
> Please note that using a `MemoryStream` will use up significantly more memory, especially for larger files.
```c#
XlsxToHtmlConverter.Converter.ConvertXlsx(filename, outputStream, true);
```
### Conversion Configurations
`ConverterConfig` include flexible and customizable conversion configurations.
> In rare cases where the converter is unable to produce the correct stylings, it is suggested to set `ConvertStyles` to `false`, which will at least ensure the conversion of all the content with default stylings.
```c#
XlsxToHtmlConverter.ConverterConfig config = new XlsxToHtmlConverter.ConverterConfig()
{
PageTitle = "My Title",
PresetStyles = XlsxToHtmlConverter.ConverterConfig.DefaultPresetStyles + " body { background-color: skyblue; } table { width: 100%; }",
ErrorMessage = "An unhandled error occured during the conversion: {EXCEPTION}",
Encoding = System.Text.Encoding.UTF8,
BufferSize = 65536,
ConvertStyles = true,
ConvertSizes = true,
ConvertNumberFormats = true,
ConvertPictures = true,
ConvertShapes = true,
ConvertSheetTitles = true,
ConvertHiddenSheets = false,
ConvertFirstSheetOnly = false,
ConvertHtmlBodyOnly = false,
UseHtmlStyleClasses = true,
UseHexColors = true,
RoundingDigits = 2
};
```
### Progress Callback
A progress callback event can be set up with `ConverterProgressCallbackEventArgs`, where things like `ProgressPercent` can be used.
```c#
EventHandler progressCallback = ConverterProgressCallback;
```
```c#
private static void ConverterProgressCallback(object sender, XlsxToHtmlConverter.ConverterProgressCallbackEventArgs e)
{
string info = string.Format("{0:##0.00}% (Sheet {1} of {2} | Row {3} of {4})", e.ProgressPercent, e.CurrentSheet, e.TotalSheets, e.CurrentRow, e.TotalRows);
string progress = new string('█', (int)(e.ProgressPercent / 2)) + new string('░', (int)((100 - e.ProgressPercent) / 2));
Console.WriteLine(info + new string(' ', 5) + progress);
}
```
## License
This project is under the [MIT License](https://github.com/Fei-Sheng-Wu/XlsxToHtmlConverter/blob/master/LICENSE.txt).