From 841971e55e6e4d71d8b3f483f4b31e540ddb9733 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 28 Oct 2025 13:30:44 +0200 Subject: [PATCH 1/5] docs(Spreadsheet): Explain that we expect XLSX files --- components/spreadsheet/overview.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/components/spreadsheet/overview.md b/components/spreadsheet/overview.md index d9855f3191..1f2f0ab06a 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 `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 or XLS file to XLSX. Then, use the XLSX byte array to set the Spreadsheet `Data` parameter. +* Convert an [exported XLSX file](#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: From cd62b5a0f170d34fa24cf316b1cbc6acd2dc9468 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 28 Oct 2025 13:41:44 +0200 Subject: [PATCH 2/5] Update components/spreadsheet/overview.md --- components/spreadsheet/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/spreadsheet/overview.md b/components/spreadsheet/overview.md index 1f2f0ab06a..380880d8d4 100644 --- a/components/spreadsheet/overview.md +++ b/components/spreadsheet/overview.md @@ -48,7 +48,7 @@ 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 `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: +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 or XLS file to XLSX. Then, use the XLSX byte array to set the Spreadsheet `Data` parameter. * Convert an [exported XLSX file](#spreadsheet-reference-and-methods) to another office document format before saving. From 233f8aefe071b4f0a12b9211b0431c2189f6e25a Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 28 Oct 2025 13:48:10 +0200 Subject: [PATCH 3/5] Update components/spreadsheet/overview.md --- components/spreadsheet/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/spreadsheet/overview.md b/components/spreadsheet/overview.md index 380880d8d4..1ac9b9179c 100644 --- a/components/spreadsheet/overview.md +++ b/components/spreadsheet/overview.md @@ -50,7 +50,7 @@ To use the Telerik Spreadsheet for Blazor: 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 or XLS file to XLSX. Then, use the XLSX byte array to set the Spreadsheet `Data` parameter. +* 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` and `Export()` to an office file format. Then, use the generated XLSX byte array to set the Spreadsheet `Data` parameter. * Convert an [exported XLSX file](#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). From ab67a26a972d21efa126e224b4d66bb99fdad397 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 28 Oct 2025 13:48:49 +0200 Subject: [PATCH 4/5] Update components/spreadsheet/overview.md --- components/spreadsheet/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/spreadsheet/overview.md b/components/spreadsheet/overview.md index 1ac9b9179c..582c4c50e7 100644 --- a/components/spreadsheet/overview.md +++ b/components/spreadsheet/overview.md @@ -51,7 +51,7 @@ To use the Telerik Spreadsheet for Blazor: 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` and `Export()` to an office file format. Then, use the generated XLSX byte array to set the Spreadsheet `Data` parameter. -* Convert an [exported XLSX file](#spreadsheet-reference-and-methods) to another office document format before saving. +* 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). From fc4fb9cb5c9305123875232c7f28de752b8c4f05 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 28 Oct 2025 13:49:39 +0200 Subject: [PATCH 5/5] Update components/spreadsheet/overview.md --- components/spreadsheet/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/spreadsheet/overview.md b/components/spreadsheet/overview.md index 582c4c50e7..b2ac93a753 100644 --- a/components/spreadsheet/overview.md +++ b/components/spreadsheet/overview.md @@ -50,7 +50,7 @@ To use the Telerik Spreadsheet for Blazor: 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` and `Export()` to an office file format. Then, use the generated XLSX byte array to set the Spreadsheet `Data` parameter. +* 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).