diff --git a/components/spreadsheet/overview.md b/components/spreadsheet/overview.md index d9855f3191..b2ac93a753 100644 --- a/components/spreadsheet/overview.md +++ b/components/spreadsheet/overview.md @@ -18,7 +18,7 @@ The Spreadsheet for Blazor enables users to view and edit tabular data with an E To use the Telerik Spreadsheet for Blazor: 1. Add the `TelerikSpreadsheet` tag. -1. (optional) Set the `Data` parameter to a byte array to load an existing Excel file. +1. (optional) Set the `Data` parameter to a byte array to load an existing Excel file in Open XML (XLSX) format. [Using other formats is also possible](#spreadsheet-file-format). >caption Basic Blazor Spreadsheet @@ -46,6 +46,16 @@ To use the Telerik Spreadsheet for Blazor: ```` +## Spreadsheet File Format + +The Telerik Spreadsheet component loads and exports files in the Open XML SpreadsheetML (XLSX) format. If you want to work with other formats, consider [Telerik Document Processing](slug:dpl-in-blazor). The library includes [different Spreadsheet `FormatProvider`s](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/formats-and-conversion/general-information), which allow you to convert from one format to another. Here are a few possible use cases: + +* Convert a [CSV](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/formats-and-conversion/csv/csvformatprovider#import) or [XLS](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/formats-and-conversion/import-and-export-to-excel-file-formats/xls/xlsformatprovider#import) file to [XLSX](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/formats-and-conversion/import-and-export-to-excel-file-formats/xlsx/xlsxformatprovider#export). Use the correct `FormatProvider`, depending on the format that you want to `Import()` to a Telerik [`Workbook`](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/working-with-workbooks/working-with-workbooks-what-is-workbook) and `Export()` to an office file format. Then, use the generated XLSX byte array to set the Spreadsheet `Data` parameter. +* Convert an [XLSX file that was exported by the Telerik Spreadsheet](#spreadsheet-reference-and-methods) to another office document format before saving. +* [Create an XLSX file from `IEnumerable` and pass it to the Spreadsheet](slug:spreadsheet-kb-bind-to-json-ienumerable-list-collection). +* [Read an exported XLSX file and obtain all cell values](slug:spreadsheet-kb-get-cell-values). + + ## Tools The Spreadsheet provides built-in tools that perform various actions such as: