diff --git a/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md b/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md
index 2ff76044c3..37979f0c26 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md
@@ -64,7 +64,7 @@ Syncfusion.XlsIO.Net.Core
-**Retired Platforms**
+### Retired Platforms
The following assemblies need to be referenced in your application based on the platform.
@@ -217,7 +217,7 @@ Syncfusion.XlsIORenderer.NET
-**Retired Platforms**
+### Retired Platforms
The following assemblies need to be referenced in your application based on the platform.
@@ -247,6 +247,8 @@ Syncfusion.ExcelToPdfConverter.Base
N> Excel to PDF conversion is supported from .NET Framework 2.0 and .NET Standard 1.4 onwards.
+N> Starting with v16.2.0.x, in addition to the assemblies listed above, you must also reference the `Syncfusion.Licensing` assembly and include a license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
+
## Converting Excel Worksheet to Image
For converting an Excel worksheet to image, the following assemblies need to be referenced in your application.
@@ -295,7 +297,7 @@ Syncfusion.XlsIORenderer.NET
-**Retired Platforms**
+### Retired Platforms
The following assemblies need to be referenced in your application based on the platform.
@@ -323,6 +325,8 @@ Syncfusion.Compression.Base
N> Worksheet to image conversion is supported from .NET Framework 2.0 and .NET Standard 1.4 onwards.
+N> Starting with v16.2.0.x, in addition to the assemblies listed above, you must also reference the `Syncfusion.Licensing` assembly and include a license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
+
## Converting Excel Chart to Image
For converting an Excel chart to image, the following assemblies need to be referenced in your application.
@@ -372,7 +376,7 @@ Syncfusion.XlsIORenderer.NET
-**Retired Platforms**
+### Retired Platforms
The following assemblies need to be referenced in your application based on the platform.
@@ -402,4 +406,11 @@ Syncfusion.SfChart.WPF
N> 1. Chart to image conversion is supported from .NET Framework 4.0 and .NET Standard 2.0 onwards.
-N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+
+## See Also
+
+* [Overview of Excel Library (XlsIO)](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview)
+* [Create Excel File in C# and VB.NET](https://help.syncfusion.com/document-processing/excel/excel-library/net/create-excel-file-csharp-vbnet)
+* [NuGet Packages](https://help.syncfusion.com/document-processing/nuget-packages)
+* [Licensing Overview](https://help.syncfusion.com/document-processing/licensing/overview)
diff --git a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Filtering.md b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Filtering.md
index f51fee15d1..67ac1df0b9 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Filtering.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Filtering.md
@@ -1,25 +1,27 @@
---
-title: Filtering | Excel library | Syncfusion
+title: Filtering | Excel Library | Syncfusion
description: In this section, you can learn about how to filter data in an Excel document using .NET Excel Library.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Filtering Data in Excel Document
+# Filtering Data in Excel Worksheet
-Using [AutoFilters](https://support.office.com/en-US/article/Filter-data-in-a-range-or-table-01832226-31b5-4568-8806-38c37dcc180e), data can be filtered to enable quick and easy way to find and work with a subset of data in a range of cells. When the data is filtered, entire rows are hidden if values in one or more columns does not meet the filtering criteria. The following are the types of filters that can be used in XlsIO.
+Using AutoFilters, data can be filtered to provide a quick and easy way to find and work with a subset of data in a range of cells. When the data is filtered, entire rows are hidden if values in one or more columns do not meet the filtering criteria. The following types of filters are available in XlsIO through the [IAutoFilter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html) interface:
-* Custom Filter (Conditional)
-* Combination Filter (Text and DateTime filter)
-* Dynamic Filter
-* Color Filter
-* Icon Filter
-* Advanced Filter
+* [Custom Filter (Conditional)](#custom-filter) using [ExcelFilterCondition](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelFilterCondition.html)
+* [Combination Filter](#combination-filter) (Text and DateTime)
+* [Dynamic Filter](#dynamic-filter) using [DynamicFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.DynamicFilterType.html)
+* [Color Filter](#color-filter) using [ExcelColorFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelColorFilterType.html)
+* [Icon Filter](#icon-filter) using [ExcelIconSetType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelIconSetType.html)
+* [Advanced Filter](#advanced-filter) using [ExcelFilterAction](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelFilterAction.html)
-## Applying Filter
+N> The column index used in `worksheet.AutoFilters[index]` is **zero-based** and is relative to the `FilterRange`. The first column of the filter range is index `0`.
-The following code example illustrates how to apply simple auto filters.
+## Applying Top10 Filter
+
+The following code example illustrates how to apply a [Top10](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_IsTop) auto filter that retains the top N cells of a column. To apply a Top10 filter, the [IsTop](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_IsTop) and [IsTop10](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_IsTop10) properties must be set to `true`, and [Top10Number](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_Top10Number) must be set to the number of cells to keep.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Filter/.NET/Filter/Filter/Program.cs,180" %}
@@ -196,9 +198,9 @@ A complete working example to apply custom filter on Excel data in C# is present
## Combination Filter
-This filter contains both Text filter and DateTime filter. It filters the data based on multiple criteria.
+A combination filter combines text and date/time filters to filter data on multiple criteria in a single column. Use [AddTextFilter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_AddTextFilter_System_String___) to add text values and [AddDateFilter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_AddDateFilter_System_DateTime_Syncfusion_XlsIO_DateTimeGroupingType_) to add date values; the available [DateTimeGroupingType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.DateTimeGroupingType.html) values are `Year`, `Month`, `Day`, `Hour`, `Minute`, and `Second`.
-The following code example illustrates how to apply combination filter with multiple of Text filter and DateTime filter.
+The following code example illustrates how to apply a combination filter that includes both text and date/time filters.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Combination%20Filter/.NET/Combination%20Filter/Combination%20Filter/Program.cs,180" %}
@@ -287,7 +289,7 @@ A complete working example to apply combination filter on Excel data in C# is pr
## Dynamic Filter
-Dynamic filter is a relative date filter, which filters data based on [DynamicFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.DynamicFilterType.html) enumeration.
+A dynamic filter is a relative date filter that filters data based on the [DynamicFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.DynamicFilterType.html) enumeration.
The following code example illustrates how to apply Dynamic filter.
@@ -364,9 +366,9 @@ A complete working example to apply dynamic filter on Excel data in C# is presen
## Color Filter
-Color Filter can be used to filter data based on the color applied to the cell or the color applied to the text in the cell.
+A color filter can be used to filter data based on the color applied to the cell (background) or the color applied to the text (font) in the cell. Use [AddColorFilter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_AddColorFilter_Syncfusion_Drawing_Color_Syncfusion_XlsIO_ExcelColorFilterType_) with the [ExcelColorFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelColorFilterType.html) value `CellColor` or `FontColor`.
-The following code example illustrates how to apply color filter based on cell color (fill color applied to the cell).
+The following code example illustrates how to apply a color filter based on cell color (fill color applied to the cell).
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Cell%20Color%20Filter/.NET/Cell%20Color%20Filter/Cell%20Color%20Filter/Program.cs,180" %}
@@ -439,9 +441,9 @@ End Using
A complete working example to apply color filter on Excel data based on cell color in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Editing%20Excel%20cells/Cell%20Color%20Filter/.NET/Cell%20Color%20Filter).
-To filter cells based on font color of the text inside cells just change the [ExcelColorFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelColorFilterType.html) to Font Color.
+To filter cells based on the font color of the text inside cells, change the [ExcelColorFilterType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelColorFilterType.html) to `FontColor`.
-The following code example illustrates how to filter the cells based on font color.
+The following code example illustrates how to filter cells based on font color.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Font%20Color%20Filter/.NET/Font%20Color%20Filter/Font%20Color%20Filter/Program.cs,180" %}
@@ -516,9 +518,9 @@ A complete working example to apply color filter on Excel data based on font col
## Icon Filter
-Icon filter can be used to filter data that has conditional formatting with Icon Sets applied. Applying Icon Sets for numeric data adds icons to each cell based on the value present in that cell. Using Icon Filter, the data that has only a specific Icon in it can be filtered easily.
+An icon filter can be used to filter data that has conditional formatting with icon sets applied. Applying icon sets to numeric data adds icons to each cell based on the value present in that cell. Using the icon filter, only the data with a specific icon can be filtered. The second parameter of [AddIconFilter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAutoFilter.html#Syncfusion_XlsIO_IAutoFilter_AddIconFilter_Syncfusion_XlsIO_ExcelIconSetType_System_Int32_) is the zero-based index of the icon within the icon set.
-The following code example illustrates how to apply icon filter.
+The following code example illustrates how to apply an icon filter.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Icon%20Filter/.NET/Icon%20Filter/Icon%20Filter/Program.cs,180" %}
@@ -593,19 +595,16 @@ A complete working example to apply icon filter on Excel data in C# is present o
## Advanced Filter
-Advanced Filter can be used to perform more complex filtering other than basic filters. Data can be filtered with custom defined criteria range.
-
-Advanced Filter support two types of filter action.
+The advanced filter can be used to perform more complex filtering beyond basic filters. Data can be filtered with a custom-defined criteria range.
-1. Filter in Place
-2. Filter Copy
+The advanced filter supports two types of [ExcelFilterAction](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelFilterAction.html):
-**Filter in Place**: Filter data in same location.
-**Filter Copy**: Filter and copy data into new location within a worksheet.
+1. `FilterInPlace`: Filter data in the same location.
+2. `FilterCopy`: Filter and copy data into a new location within a worksheet.
-Advanced Filter also provides an option to filter the unique records. This will remove the duplicate record from filtered data.
+The advanced filter also provides an option to filter only the unique records, which removes duplicates from the filtered data. Pass `true` as the last argument of [AdvancedFilter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_AdvancedFilter_Syncfusion_XlsIO_ExcelFilterAction_Syncfusion_XlsIO_IRange_Syncfusion_XlsIO_IRange_Syncfusion_XlsIO_IRange_System_Boolean_) to enable unique-record filtering.
-The following code example illustrates how to apply Advanced Filter in worksheet.
+The following code example illustrates how to apply an advanced filter to a worksheet.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Advanced%20Filter/.NET/Advanced%20Filter/Advanced%20Filter/Program.cs,180" %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Find-and-Replace.md b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Find-and-Replace.md
index c27d29b2d7..b29ef625ec 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Find-and-Replace.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Find-and-Replace.md
@@ -1,22 +1,22 @@
---
-title: Find and Replace | Excel library | Syncfusion
-description: In this section, you can learn about how to find and replace in an Excel document using .NET Excel Library.
+title: Find and Replace | Excel Library | Syncfusion
+description: In this section, you can learn how to find and replace text, numbers, formulas, values, and comments in an Excel worksheet using the .NET Excel Library.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Find and Replace in Excel Document
+# Find and Replace in Excel Worksheet
-**Find**
+## Find
-XlsIO provides the following options to perform find using [ExcelFindType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelFindType.html) in an Excel workbook or worksheet:
+XlsIO provides the following options to perform a find operation using [ExcelFindType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelFindType.html) in an Excel workbook or worksheet:
* Search for number
* Search for text
* Search for values
* Search for comments
-* Search for formula
+* Search for formulas
Additionally, you can search for case-sensitive data and match the entire cell contents using [ExcelFindOptions](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelFindOptions.html). All occurrences of a text in an Excel worksheet can be found using the [FindAll](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_FindAll_System_Boolean_) method.
@@ -31,22 +31,22 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IWorkbook workbook = application.Workbooks.Open(Path.GetFullPath(@"Data/InputTemplate.xlsx"));
IWorksheet worksheet = workbook.Worksheets[0];
- //Searches for the given string within the text of worksheet
+ //Searches for the given string within the text of a worksheet
IRange[] textCells = worksheet.FindAll("Gill", ExcelFindType.Text);
- //Searches for the given string within the text of worksheet
+ //Searches for the given number within a worksheet
IRange[] numberCells = worksheet.FindAll(700, ExcelFindType.Number);
//Searches for the given string in formulas
IRange[] formulaCells = worksheet.FindAll("=SUM(F10:F11)", ExcelFindType.Formula);
- //Searches for the given string in calculated value, number and text
+ //Searches for the given value in the calculated result, number, or text
IRange[] valueCells = worksheet.FindAll("41", ExcelFindType.Values);
//Searches for the given string within the text of worksheet and case matched
IRange[] textMatchingCaseCells = worksheet.FindAll("Pen Set", ExcelFindType.Text, ExcelFindOptions.MatchCase);
- //Searches for the given string within the text of worksheet and the entire cell content matching to search text
+ //Searches for the given string within the text of a worksheet and the entire cell content matching the search text
IRange[] textMatchingEntireContentCells = worksheet.FindAll("5", ExcelFindType.Text, ExcelFindOptions.MatchEntireCellContent);
foreach (IRange cell in textCells)
@@ -82,7 +82,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
foreach (IRange cell in textMatchingEntireContentCells)
{
//Highlight found entire content matching text cells in teal
- cell.CellStyle.Color = Syncfusion.Drawing.Color.FromArgb(255, 0, 128, 128);
+ cell.CellStyle.Color = Syncfusion.Drawing.Color.FromArgb(255, 0, 128, 128);
}
//Saving the workbook
@@ -98,26 +98,26 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IWorkbook workbook = application.Workbooks.Open("../../Data/InputTemplate.xlsx");
IWorksheet sheet = workbook.Worksheets[0];
- //Searches for the given string within the text of worksheet
- IRange[] result1 = worksheet.FindAll("Gill", ExcelFindType.Text);
+ //Searches for the given string within the text of a worksheet
+ IRange[] result1 = sheet.FindAll("Gill", ExcelFindType.Text);
- //Searches for the given string within the text of worksheet
- IRange[] result2 = worksheet.FindAll(700, ExcelFindType.Number);
+ //Searches for the given number within a worksheet
+ IRange[] result2 = sheet.FindAll(700, ExcelFindType.Number);
//Searches for the given string in formulas
- IRange[] result3 = worksheet.FindAll("=SUM(F10:F11)", ExcelFindType.Formula);
+ IRange[] result3 = sheet.FindAll("=SUM(F10:F11)", ExcelFindType.Formula);
- //Searches for the given string in calculated value, number and text
- IRange[] result4 = worksheet.FindAll("41", ExcelFindType.Values);
+ //Searches for the given value in the calculated result, number, or text
+ IRange[] result4 = sheet.FindAll("41", ExcelFindType.Values);
//Searches for the given string in comments
- IRange[] result5 = worksheet.FindAll("Desk", ExcelFindType.Comments);
+ IRange[] result5 = sheet.FindAll("Desk", ExcelFindType.Comments);
- //Searches for the given string within the text of worksheet and case matched
- IRange[] result6 = worksheet.FindAll("Pen Set", ExcelFindType.Text, ExcelFindOptions.MatchCase);
+ //Searches for the given string within the text of a worksheet and case-matched
+ IRange[] result6 = sheet.FindAll("Pen Set", ExcelFindType.Text, ExcelFindOptions.MatchCase);
- //Searches for the given string within the text of worksheet and the entire cell content matching to search text
- IRange[] result7 = worksheet.FindAll("5", ExcelFindType.Text, ExcelFindOptions.MatchEntireCellContent);
+ //Searches for the given string within the text of a worksheet and the entire cell content matching the search text
+ IRange[] result7 = sheet.FindAll("5", ExcelFindType.Text, ExcelFindOptions.MatchEntireCellContent);
//Saving the workbook
workbook.SaveAs("Find.xlsx");
@@ -131,25 +131,25 @@ Using excelEngine As New ExcelEngine()
Dim workbook As IWorkbook = application.Workbooks.Open("../../Data/InputTemplate.xlsx")
Dim worksheet As IWorksheet = workbook.Worksheets(0)
- 'Searches for the given string within the text of worksheet
+ 'Searches for the given string within the text of a worksheet
Dim result1 As IRange() = worksheet.FindAll("Gill", ExcelFindType.Text)
- 'Searches for the given string within the text of worksheet
+ 'Searches for the given number within a worksheet
Dim result2 As IRange() = worksheet.FindAll(700, ExcelFindType.Number)
'Searches for the given string in formulas
Dim result3 As IRange() = worksheet.FindAll("=SUM(F10:F11)", ExcelFindType.Formula)
- 'Searches for the given string in calculated value, number and text
+ 'Searches for the given value in the calculated result, number, or text
Dim result4 As IRange() = worksheet.FindAll("41", ExcelFindType.Values)
'Searches for the given string in comments
Dim result5 As IRange() = worksheet.FindAll("Desk", ExcelFindType.Comments)
- 'Searches for the given string within the text of worksheet and case matched
+ 'Searches for the given string within the text of a worksheet and case-matched
Dim result6 As IRange() = worksheet.FindAll("Pen Set", ExcelFindType.Text, ExcelFindOptions.MatchCase)
- 'Searches for the given string within the text of worksheet and the entire cell content matching to search text
+ 'Searches for the given string within the text of a worksheet and the entire cell content matching the search text
Dim result7 As IRange() = worksheet.FindAll("5", ExcelFindType.Text, ExcelFindOptions.MatchEntireCellContent)
'Saving the workbook
@@ -160,9 +160,9 @@ End Using
A complete working example to find all occurrences of text in a worksheet with different find options in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Editing%20Excel%20cells/Find/.NET/Find).
-**Replace**
+## Replace
-It is possible to replace a text with another text with the help of [Replace](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_Replace_System_String_System_String_) method which searches for text which should be changed. A string can be replaced, with the data of various data types and data sources, such as data table, data column and array.
+It is possible to replace text with other text using the [Replace](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_Replace_System_String_System_String_) method, which searches the active worksheet for the text that should be changed. The replacement value can be a string, a `DateTime` value, a `DataTable`, a `DataColumn`, or a `string[]` array.
To know more about replace overloads, please refer [Replace](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_Replace_System_String_System_Data_DataColumn_System_Boolean_) in the API documentation section.
@@ -180,10 +180,10 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Replaces the given string with another string
worksheet.Replace("Wilson", "William");
- //Replaces the given string with another string on match case
+ //Replaces the given string with another string on case match
worksheet.Replace("4.99", "4.90", ExcelFindOptions.MatchCase);
- //Replaces the given string with another string matching entire cell content to the search word
+ //Replaces the given string with another string where the entire cell content matches the search word
worksheet.Replace("Pen Set", "Pen", ExcelFindOptions.MatchEntireCellContent);
//Replaces the given string with DateTime value
@@ -209,10 +209,10 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Replaces the given string with another string
worksheet.Replace("Wilson", "William");
- //Replaces the given string with another string on match case
+ //Replaces the given string with another string on case match
worksheet.Replace("4.99", "4.90", ExcelFindOptions.MatchCase);
- //Replaces the given string with another string matching entire cell content to the search word
+ //Replaces the given string with another string where the entire cell content matches the search word
worksheet.Replace("Pen Set", "Pen", ExcelFindOptions.MatchEntireCellContent);
//Replaces the given string with DateTime value
@@ -236,10 +236,10 @@ Using excelEngine As New ExcelEngine()
' Replaces the given string with another string
worksheet.Replace("Wilson", "William")
- ' Replaces the given string with another string on match case
+ ' Replaces the given string with another string on case match
worksheet.Replace("4.99", "4.90", ExcelFindOptions.MatchCase)
- ' Replaces the given string with another string matching entire cell content to the search word
+ ' Replaces the given string with another string where the entire cell content matches the search word
worksheet.Replace("Pen Set", "Pen", ExcelFindOptions.MatchEntireCellContent)
' Replaces the given string with DateTime value
@@ -254,4 +254,4 @@ End Using
{% endhighlight %}
{% endtabs %}
-A complete working example to replace all occurrences of given string in a worksheet with different find options in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Editing%20Excel%20cells/Replace/.NET/Replace).
\ No newline at end of file
+A complete working example to replace all occurrences of a given string in a worksheet with different replace options in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Editing%20Excel%20cells/Replace/.NET/Replace).
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Hyperlink.md b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Hyperlink.md
index b7e9678840..e85d17f17e 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Hyperlink.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Hyperlink.md
@@ -1,21 +1,21 @@
---
-title: Hyperlink | Excel library | Syncfusion
-description: In this section, you can learn about how to add hyperlink in an Excel document using .NET Excel Library.
+title: Hyperlink | Excel Library | Syncfusion
+description: In this section, you can learn how to add, modify, and remove hyperlinks in an Excel worksheet using the .NET Excel Library.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Hyperlink in Excel Document
+# Hyperlink in Excel Worksheet
## Create Hyperlink
-Hyperlinks can be created in a workbook to provide quick access to web pages, locations within your document, and files. A hyperlink may target any one of the following
+Hyperlinks can be created in a workbook to provide quick access to web pages, locations within the workbook, and external files. A hyperlink can target any of the following targets through the [ExcelHyperLinkType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelHyperLinkType.html) enum:
-* Worksheet range
-* Web URL
-* E-mail
-* External files
+* [Worksheet range](#worksheet-cell-hyperlink) (`Workbook`)
+* [Web URL](#website-url-hyperlink) (`Url`)
+* [E-mail](#e-mail-hyperlink) (`Url` with `mailto:` prefix)
+* [External files](#file-opening-hyperlink) (`File` or `Unc`)
### Website URL Hyperlink
@@ -45,7 +45,9 @@ hyperlink.ScreenTip = "To know more about Syncfusion products, go through this l
{% endhighlight %}
{% endtabs %}
-### E-mail hyperlink
+### E-mail Hyperlink
+
+Use the `Url` hyperlink type with a `mailto:` prefix to create an e-mail hyperlink. The address must follow the `mailto:user@domain` format.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -75,6 +77,8 @@ hyperlink1.ScreenTip = "Send Mail"
### File Opening Hyperlink
+Use the `File` hyperlink type to open a file at a local path. The `Address` must be a fully qualified file path. Use the `Unc` type for files on a network share (Universal Naming Convention path, e.g., `\\server\share\folder`).
+
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
//Creating a Hyperlink for Opening Files using type as File
@@ -106,6 +110,8 @@ hyperlink2.TextToDisplay = "Hyperlink for files using File as type"
### File Opening Hyperlink with Unc
+Use the `Unc` hyperlink type for files on a network share, with the address in Universal Naming Convention format (e.g., `\\server\share\folder`).
+
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
//Creating a Hyperlink for Opening Files using type as Unc
@@ -137,6 +143,8 @@ hyperlink3.TextToDisplay = "Hyperlink for files using Unc as type"
### Worksheet Cell Hyperlink
+Use the `Workbook` hyperlink type to navigate to a cell or range within the workbook. The `Address` must follow the `SheetName!CellAddress` format (for example, `Sheet1!A15`); to target a different workbook, use `'[FileName.xlsx]SheetName!CellAddress'`.
+
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
//Creating a Hyperlink to another cell using type as Workbook
@@ -173,7 +181,7 @@ The complete code example illustrating the above options is shown below.
using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
- application.DefaultVersion = ExcelVersion.Excel2013;
+ application.DefaultVersion = ExcelVersion.Xlsx;
IWorkbook workbook = application.Workbooks.Create(1);
IWorksheet sheet = workbook.Worksheets[0];
@@ -313,7 +321,7 @@ A complete working example to add hyperlinks in C# is present on [this GitHub pa
## Modifying Existing Hyperlink
-The properties of existing hyperlink can be modified by accessing it through the [IRange](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html) instance.
+The properties of an existing hyperlink can be modified by accessing it through the [IRange](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html) instance. Use the `IRange.Hyperlinks` indexer to retrieve the hyperlink at a given position; the index is zero-based and applies to the first hyperlink found on that range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Modify%20Hyperlink/.NET/Modify%20Hyperlink/Modify%20Hyperlink/Program.cs,180" %}
@@ -373,7 +381,7 @@ A complete working example to modify existing hyperlink in C# is present on [thi
## Removing Hyperlink
-Similarly, a hyperlink can also be removed from a range by accessing it through the [IRange](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html) instance.
+Similarly, a hyperlink can be removed from a cell or range by accessing it through the [IRange](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html) instance. The example below removes the first hyperlink from the range `C7`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Remove%20Hyperlink/.NET/Remove%20Hyperlink/Remove%20Hyperlink/Program.cs,180" %}
@@ -430,9 +438,9 @@ A complete working example to remove existing hyperlink in C# is present on [thi
## Hyperlinks on Shapes
-### Adding Hyperlinks om Shapes
+### Adding Hyperlinks on Shapes
-Hyperlink can be added to the following shapes.
+A hyperlink can be added to the following shapes:
* Picture
* AutoShape
@@ -607,7 +615,7 @@ A complete working example to modify shape hyperlink in C# is present on [this G
### Removing Hyperlinks from Shapes
-The following code snippet explains how to remove hyperlink of shape.
+The following code snippet explains how to remove a hyperlink from a shape. To remove a shape's hyperlink, access the shape through the [IShape.Hyperlink](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IShape.html#Syncfusion_XlsIO_IShape_Hyperlink) property and call `Remove` on the worksheet's hyperlink collection, or remove the hyperlink at the sheet level using `worksheet.HyperLinks.RemoveAt(index)` (as shown in the example).
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Remove%20Shape%20Hyperlink/.NET/Remove%20Shape%20Hyperlink/Remove%20Shape%20Hyperlink/Program.cs,180" %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/List-of-APIs-under-IRange.md b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/List-of-APIs-under-IRange.md
index 2e01a67968..f83657e858 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/List-of-APIs-under-IRange.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/List-of-APIs-under-IRange.md
@@ -1,16 +1,16 @@
---
-title: List of APIs under IRange | Excel library | Syncfusion
-description: In this section, you can learn about the list of APIs under IRange for Excel document using .NET Excel Library.
+title: List of APIs under IRange | Excel Library | Syncfusion
+description: In this section, you can learn about the properties and methods of the IRange interface for an Excel worksheet using the .NET Excel Library.
platform: document-processing
control: XlsIO
documentation: UG
---
-# List of APIs under IRange
+# List of APIs under IRange
## Cell Address
-The following code example illustrates the usage of [Address](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Address), [AddressGlobal](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressGlobal), [AddressLocal](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressLocal), [AddressR1C1](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressR1C1), [AddressR1C1Local](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressR1C1Local) properties.
+The following code example illustrates the usage of [Address](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Address), [AddressGlobal](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressGlobal), [AddressLocal](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressLocal), [AddressR1C1](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressR1C1), and [AddressR1C1Local](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_AddressR1C1Local) properties. `Address` and `AddressLocal` return the range in A1 style (in English or the current locale), while `AddressR1C1` and `AddressR1C1Local` return the range in R1C1 style.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -161,7 +161,7 @@ End Using
## Borders
-The following code example illustrates how to set border styles for a worksheet range using [Borders](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Borders) property.
+The following code example illustrates how to set border styles for a worksheet range using the [Borders](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Borders) property. The [ExcelBordersIndex](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelBordersIndex.html) and [ExcelLineStyle](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelLineStyle.html) enums identify which border edge to style and which line style to apply.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -242,9 +242,9 @@ End Using
{% endhighlight %}
{% endtabs %}
-## Built-In-Style
+## Built-In Style
-The following code example illustrates how to add [BuiltInStyle](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_BuiltInStyle) for a worksheet range.
+The following code example illustrates how to add a [BuiltInStyle](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_BuiltInStyle) for a worksheet range. The [BuiltInStyles](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.BuiltInStyles.html) enum provides the available built-in style names.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -303,9 +303,9 @@ End Using
## Calculated Value
-[CalculatedValue](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_CalculatedValue) is the evaluated value of the formula. The following code example illustrates how to get the **CalculatedValue** of the formula.
+[CalculatedValue](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_CalculatedValue) is the evaluated value of a formula. The following code example illustrates how to get the **CalculatedValue** of a formula. It is recommended to call [DisableSheetCalculations](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_DisableSheetCalculations) after reading the value to free resources.
-N> It is mandatory to enable sheet calculations i.e., **worksheet.EnableSheetCalculations();** before accessing the **CalculatedValue**. Else, **CalculatedValue** will be returned as null.
+N> It is mandatory to enable sheet calculations via [EnableSheetCalculations](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_EnableSheetCalculations) before accessing the **CalculatedValue**; otherwise, **CalculatedValue** will be returned as `null`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -394,7 +394,7 @@ End Using
## Cells
-[Cells](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Cells) property maintains the collection of cells in a worksheet range. The following code example illustrates how to access this property.
+The [Cells](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Cells) property returns an `IRange[]` array containing the individual cells in the worksheet range. The following code example illustrates how to access this property.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -461,7 +461,7 @@ End Using
## Cell Style Name
-[CellStyleName](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_CellStyleName) represents the name of the style of worksheet range/cell. The default value is **Normal**.
+[CellStyleName](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_CellStyleName) represents the name of the style of a worksheet range or cell. The default value is **Normal**. Use [IStyle](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IStyle.html) to create custom styles and [ExcelKnownColors](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelKnownColors.html) for standard color values.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -538,7 +538,7 @@ End Using
## Column
-[Column](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Column) property gets the column index of first column in worksheet range, which is one-index based.
+The [Column](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Column) property returns the column index of the first column in the worksheet range; the index is **one-based**.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -588,7 +588,7 @@ End Using
## Columns
-[Columns](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Columns) property maintains the collection of columns in a worksheet range.
+The [Columns](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_Columns) property returns an `IRange[]` array containing the individual columns in the worksheet range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -717,7 +717,7 @@ For more details about Data Validation, [click here.](https://help.syncfusion.co
## End
-[End](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_End) property returns the last cell in the particular worksheet range.
+The [End](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_End) property returns the last cell in the given worksheet range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -767,7 +767,7 @@ End Using
## Entire Column
-[EntireColumn](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_EntireColumn), as the name says gets the entire column of the particular range.
+The [EntireColumn](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_EntireColumn) property, as the name says, returns the entire column of the given range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -819,7 +819,7 @@ N> Using EntireColumn property excessively leads to time consumption and affects
## Entire Row
-[EntireRow](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_EntireRow), as the name says gets the entire row of the particular range.
+The [EntireRow](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_EntireRow) property, as the name says, returns the entire row of the given range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -1213,7 +1213,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Set value through Value property
worksheet.Range["B1"].Value = "Hello World";
- //Set date time through DatTime property
+ //Set date time through DateTime property
worksheet.Range["B2"].DateTime = DateTime.Now;
//Set value through Value2 property
@@ -1242,7 +1242,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Set value through Value property
worksheet.Range["B1"].Value = "Hello World";
- //Set date time through DatTime property
+ //Set date time through DateTime property
worksheet.Range["B2"].DateTime = DateTime.Now;
//Set value through Value2 property
@@ -1270,7 +1270,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
'Set value through Value property
worksheet.Range("B1").Value = "Hello World"
- 'Set date time through DatTime property
+ 'Set date time through DateTime property
worksheet.Range("B2").DateTime = DateTime.Now
'Set value through Value2 property
diff --git a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Sorting.md b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Sorting.md
index 65e4017e7d..2face37f72 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Sorting.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Cells-Manipulation/Sorting.md
@@ -1,12 +1,12 @@
---
-title: Sorting | Excel library | Syncfusion
-description: In this section, you can learn about how to sort data in an Excel document using .NET Excel Library.
+title: Sorting | Excel Library | Syncfusion
+description: In this section, you can learn how to sort data in an Excel worksheet by cell values, font color, and cell color using the .NET Excel Library.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Sorting Data in Excel Document
+# Sorting Data in Excel Worksheet
A range of cells in Excel worksheet can be sorted based on data in one or more columns. Following types of sorting is supported in XlsIO:
@@ -14,10 +14,12 @@ A range of cells in Excel worksheet can be sorted based on data in one or more c
* Font Color
* Cell Color
-N> Currently XlsIO don’t support sorting based on cell icon, parsing and serialization of its sorting details.
+N> Currently XlsIO dont support sorting based on cell icon, parsing and serialization of its sorting details.
## Cell Values
+The [OrderBy](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.OrderBy.html) enum supports `Ascending` and `Descending` for value-based sorting.
+
The following code example illustrates how to sort a range of cells by values.
{% tabs %}
@@ -45,7 +47,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Sort based on the sort Field attribute
sorter.Sort();
- //Creates the data sorter
+ //A new data sorter is required because the previous sort has been applied
sorter = workbook.CreateDataSorter();
//Range to sort
@@ -147,7 +149,9 @@ A complete working example to sort Excel data based on cell values in C# is pres
## Font Color
-The following code example illustrates how to move a range of cells with the specified font color to either top or bottom of the sorting range.
+The [OrderBy](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.OrderBy.html) enum supports `OnTop` and `OnBottom` for color-based sorting. When multiple sort fields are added on the **same column index** with different colors, the first color takes priority over the second, and so on. Set the color to sort on through the [ISortField.Color](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ISortField.html#Syncfusion_XlsIO_ISortField_Color) property.
+
+The following code example illustrates how to sort a range of cells so that the cells with the specified font color appear at the top or bottom of the sorting range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Sort%20on%20Font%20Color/.NET/Sort%20on%20Font%20Color/Sort%20on%20Font%20Color/Program.cs,180" %}
@@ -174,7 +178,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Sort based on the sort Field attribute
sorter.Sort();
- //Creates the data sorter
+ //A new data sorter is required because the previous sort has been applied
sorter = workbook.CreateDataSorter();
//Range to sort
@@ -211,6 +215,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
sorter.SortRange = sheet.Range["A2:D16"];
//Creates the sort field with the column index, sort based on and order by attribute
+ //First color takes priority over the second for the same column
ISortField sortField1 = sorter.SortFields.Add(2, SortOn.FontColor, OrderBy.OnTop);
//Specifies the color to sort the data
@@ -236,19 +241,20 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
Dim workbook As IWorkbook = application.Workbooks.Open("Sample.xlsx")
Dim sheet As IWorksheet = workbook.Worksheets(0)
- 'Creates the Data sorter
+ 'Creates the data sorter
Dim sorter As IDataSort = workbook.CreateDataSorter()
'Specifies the sort range
sorter.SortRange = sheet.Range("A2:D16")
- 'Adds the sort field with column index, sort based on and order by attribute
+ 'Adds the sort field with column index, based on and order by attribute
+ 'First color takes priority over the second for the same column
Dim field1 As ISortField = sorter.SortFields.Add(2, SortOn.FontColor, OrderBy.OnTop)
'Sorts the data based on this color
field1.Color = Color.Red
- 'Adds another sort field with column index, sort based on and order by attribute
+ 'Adds another sort field with column index, based on and order by attribute
Dim field2 As ISortField = sorter.SortFields.Add(2, SortOn.FontColor, OrderBy.OnTop)
'Sorts the data based on this color
@@ -267,7 +273,7 @@ A complete working example to sort Excel data based on font color in C# is prese
## Cell Color
-The following code example illustrates how to move a range of cells with the specified cell background color to either top or bottom of the sorting range.
+The following code example illustrates how to sort a range of cells so that the cells with the specified cell background color appear at the top or bottom of the sorting range.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Editing%20Excel%20cells/Sort%20On%20Cell%20Color/.NET/Sort%20On%20Cell%20Color/Sort%20On%20Cell%20Color/Program.cs,180" %}
@@ -294,7 +300,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Sort based on the sort Field attribute
sorter.Sort();
- //Creates the data sorter
+ //A new data sorter is required because the previous sort has been applied
sorter = workbook.CreateDataSorter();
//Range to sort
@@ -331,6 +337,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
sorter.SortRange = sheet.Range["A2:D16"];
//Creates the sort field with the column index, sort based on and order by attribute
+ //First color takes priority over the second for the same column
ISortField sortField1 = sorter.SortFields.Add(2, SortOn.CellColor, OrderBy.OnTop);
//Specifies the color to sort the data
@@ -360,13 +367,14 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
'Specifies the sort range.
sorter.SortRange = sheet.Range("A2:D16")
- 'Adds the sort field with column index, sort based on and order by attribute
+ 'Adds the sort field with column index, based on and order by attribute
+ 'First color takes priority over the second for the same column
Dim field1 As ISortField = sorter.SortFields.Add(2, SortOn.CellColor, OrderBy.OnTop)
'Sorts the data based on this color
field1.Color = Color.Red
- 'Adds the sort field with column index, sort based on and order by attribute
+ 'Adds the sort field with column index, based on and order by attribute
Dim field2 As ISortField = sorter.SortFields.Add(2, SortOn.CellColor, OrderBy.OnTop)
'Sorts the data based on this color
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Appearance.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Appearance.md
index 3e4fe99861..a3d7f3d434 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Appearance.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Appearance.md
@@ -6,7 +6,7 @@ control: XlsIO
documentation: UG
---
-# Chart Appearance in Excel document
+# Chart Appearance in an Excel document
Chart appearance refers to the customization of visual elements within charts in Excel documents. Using XlsIO, you can **customize the chart appearance**.
@@ -16,7 +16,7 @@ Chart appearance refers to the customization of visual elements within charts in
The following code example illustrates how to apply a solid color to the chart area, plot area, and data series of the chart.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/Solid%20Fill/.NET/Solid%20Fill/Solid%20Fill/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -47,7 +47,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
ChartFillImpl chartFillImpl2 = serie2.SerieFormat.Fill as ChartFillImpl;
chartFillImpl2.FillType = ExcelFillType.SolidColor;
- chartFillImpl2.ForeColor = Color.FromArgb(143, 170, 220); ;
+ chartFillImpl2.ForeColor = Color.FromArgb(143, 170, 220);
//Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/Output.xlsx"));
@@ -127,7 +127,7 @@ Using excelEngine As New ExcelEngine()
workbook.SaveAs("Output.xlsx")
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
A complete working example to apply a solid fill in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Create%20and%20Edit%20Charts/Solid%20Fill/.NET/Solid%20Fill).
@@ -135,7 +135,7 @@ A complete working example to apply a solid fill in C# is present on [this GitHu
The following code example illustrates how to apply a pattern fill to the chart area, plot area, and data series of the chart.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/Pattern%20Fill/.NET/Pattern%20Fill/Pattern%20Fill/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -269,7 +269,7 @@ Using excelEngine As New ExcelEngine()
workbook.SaveAs("Output.xlsx")
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
A complete working example to apply a pattern fill in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Create%20and%20Edit%20Charts/Pattern%20Fill/.NET/Pattern%20Fill).
@@ -277,7 +277,7 @@ A complete working example to apply a pattern fill in C# is present on [this Git
The following code example illustrates how to apply a gradient fill to the chart area, plot area, and data series of the chart.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/Gradient%20Fill/.NET/Gradient%20Fill/Gradient%20Fill/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -287,13 +287,13 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IWorksheet worksheet = workbook.Worksheets[0];
IChart chart = worksheet.Charts[0];
- //Get data serie
+ //Get data series
IChartSerie serie1 = chart.Series[0];
IChartSerie serie2 = chart.Series[1];
//Set gradient fill to chart area
IChartFrameFormat chartArea = chart.ChartArea;
- chartArea.Fill.FillType = ExcelFillType.Gradient;
+ chartArea.Fill.FillType = ExcelFillType.Gradient;
chartArea.Fill.BackColor = Color.FromArgb(205, 217, 234);
chartArea.Fill.ForeColor = Color.White;
@@ -324,7 +324,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
chartFillImpl2.GradientStops.Add(gradientStopImpl3);
chartFillImpl2.GradientStops.Add(gradientStopImpl4);
- //Saving the workbook
+ //Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/Output.xlsx"));
}
{% endhighlight %}
@@ -344,7 +344,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Set gradient fill to chart area
IChartFrameFormat chartArea = chart.ChartArea;
- chartArea.Fill.FillType = ExcelFillType.Gradient;
+ chartArea.Fill.FillType = ExcelFillType.Gradient;
chartArea.Fill.BackColor = Color.FromArgb(205, 217, 234);
chartArea.Fill.ForeColor = Color.White;
@@ -429,11 +429,12 @@ Using excelEngine As New ExcelEngine()
workbook.SaveAs("Output.xlsx")
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
A complete working example to apply a gradient fill in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Create%20and%20Edit%20Charts/Gradient%20Fill/.NET/Gradient%20Fill).
### Picture Fill
+
The following code example illustrates how to apply a picture fill to the chart area, plot area, and data series of the chart.
{% tabs %}
@@ -557,7 +558,7 @@ A complete working example to apply a picture fill in C# is present on [this Git
### No Fill
-The following code example illustrates how to apply a no fill to the chart area, plot area, and data series of the chart.
+The following code example illustrates how to apply no fill to the chart area, plot area, and data series of the chart.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/No%20Fill/.NET/No%20Fill/No%20Fill/Program.cs,180" %}
@@ -584,7 +585,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Set no fill to series
serie1.SerieFormat.Fill.Visible = false;
- //Saving the workbook
+ //Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/Output.xlsx"));
}
{% endhighlight %}
@@ -655,7 +656,7 @@ A complete working example to apply a no fill in C# is present on [this GitHub p
The following code snippet illustrates how to set the layout for chart elements such as the plot area and legend.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
//Manually positioning chart plot area using Layout
chart.PlotArea.Layout.LayoutTarget = LayoutTargets.inner;
@@ -715,13 +716,13 @@ chart.Legend.Layout.TopMode = LayoutModes.edge
chart.Legend.Layout.ManualLayout.LeftMode = LayoutModes.edge
chart.Legend.Layout.ManualLayout.TopMode = LayoutModes.edge
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
### Resizing
The following code snippet illustrates how to resize chart elements such as the plot area, legend, title area, axis area, and data labels.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
//Manually resizing chart plot area using Layout
chart.PlotArea.Layout.Left = 70;
@@ -889,13 +890,13 @@ chart.Series(0).DataPoints(0).DataLabels.Layout.Top = 0.01
chart.Series(0).DataPoints(0).DataLabels.Layout.ManualLayout.Left = 0.09
chart.Series(0).DataPoints(0).DataLabels.Layout.ManualLayout.Top = 0.01
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
## Applying 3D Formats
The following code example illustrates how to apply 3D settings such as rotation, side wall, back wall, and floor settings.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/3D%20Chart/.NET/3D%20Chart/3D%20Chart/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -1002,7 +1003,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Set floor fill option
chart.Floor.Fill.FillType = ExcelFillType.Pattern;
- chart.Floor.Fill.Pattern = ExcelGradientPattern.Pat_10_Percent.Pat_30_Percent;
+ chart.Floor.Fill.Pattern = ExcelGradientPattern.Pat_30_Percent;
//Set floor fore and Back color
chart.Floor.Fill.ForeColor = Color.Blue;
chart.Floor.Fill.BackColor = Color.White;
@@ -1020,7 +1021,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
Dim workbook As IWorkbook = application.Workbooks.Create(2)
Dim sheet As IWorksheet = workbook.Worksheets(0)
- 'Insert data in sheet-1
+ 'Insert the data in sheet-1
sheet.Range("B1").Text = "Product-A"
sheet.Range("C1").Text = "Product-B"
sheet.Range("D1").Text = "Product-C"
@@ -1058,7 +1059,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
'Set floor fill option
chart.Floor.Fill.FillType = ExcelFillType.Pattern
- chart.Floor.Fill.Pattern = ExcelGradientPattern.Pat_10_Percent.Pat_30_Percent
+ chart.Floor.Fill.Pattern = ExcelGradientPattern.Pat_30_Percent
'Set floor fore and Back color
chart.Floor.Fill.ForeColor = Color.Blue
chart.Floor.Fill.BackColor = Color.White
@@ -1068,7 +1069,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
workbook.SaveAs("Chart.xlsx")
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
A complete working example to apply 3D chart formats in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Create%20and%20Edit%20Charts/3D%20Chart/.NET/3D%20Chart).
@@ -1219,7 +1220,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IApplication application = excelEngine.Excel;
application.DefaultVersion = ExcelVersion.Xlsx;
IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
- IWorksheet worksheet = workbook.Worksheets[0];
+ IWorksheet worksheet = workbook.Worksheets[0];
//Adding chart in the workbook
IChart chart = workbook.Charts.Add();
@@ -1231,7 +1232,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
chart.Pictures.AddPicture("Image.png");
//Adding hyperlink to the picture on chart
- worksheet.HyperLinks.Add((workbook.Charts[0].Pictures[0] as IShape), ExcelHyperLinkType.Url, "http://www.Syncfusion.com", "click here");
+ worksheet.HyperLinks.Add((workbook.Charts[0].Pictures[0] as IShape), ExcelHyperLinkType.Url, "https://www.Syncfusion.com", "click here");
workbook.SaveAs("Output.xlsx");
}
@@ -1254,14 +1255,14 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
chart.Pictures.AddPicture("Image.png")
'Adding hyperlink to the picture on chart
- worksheet.HyperLinks.Add(workbook.Charts(0).Pictures(0), ExcelHyperLinkType.Url, "http://www.Syncfusion.com", "click here")
+ worksheet.HyperLinks.Add(workbook.Charts(0).Pictures(0), ExcelHyperLinkType.Url, "https://www.Syncfusion.com", "click here")
workbook.SaveAs("Output.xlsx")
End Using
{% endhighlight %}
{% endtabs %}
-A complete working example for picture hyperlink in chart in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Create%20and%20Edit%20Charts/Picture%20Hyperlink%20in%20Chart/.NET/Picture%20Hyperlink%20in%20Chart).
+A complete working example for picture hyperlink in chart in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Create%20and%20Edit%20Charts/Picture%20Hyperlink%20in%20Chart/.NET/Picture%20Hyperlink%20in%20Chart).
N> XlsIO supports adding picture only to a chart in the workbook,but does not support adding picture to a chart in the worksheet.
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Area.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Area.md
index 500b8282bf..24c93f0818 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Area.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Area.md
@@ -6,9 +6,9 @@ control: XlsIO
documentation: UG
---
-# Chart Area in Excel document
+# Chart Area in an Excel document
-Chart area refers to the space that contains the entire chart or graph within a document. It includes all elements of the chart, such as data points, labels, axes, and the plot area. Using XlsIO, you **can customize various aspects of the chart area in the chart**.
+Chart area refers to the space that contains the entire chart or graph within a document. It includes all elements of the chart, such as data points, labels, axes, and the plot area. Using XlsIO, you **can customize various aspects of the chart area**.
## Formatting
@@ -169,7 +169,7 @@ A complete working example for the chart area in C# is present on [this GitHub p
### Transparency
-The following code snippet illustrates how to apply transparency in the chart area.
+The following code snippet illustrates how to apply transparency to the chart area. This snippet assumes `chartArea` is already initialized from the [Border](#border) or [Color](#color) example.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -188,4 +188,4 @@ chartArea.Fill.Transparency = 0.5
{% endhighlight %}
{% endtabs %}
-N> [Transparency](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_Transparency) is only applicable when [FillType](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_FillType) is set as SolidColor. Color-shaded fill is represented as a floating-point value ranging from 0.0 (Clear) to 1.0 (Opaque).
\ No newline at end of file
+N> [Transparency](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_Transparency) is only applicable when [FillType](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_FillType) is set as SolidColor. The value is a floating-point number ranging from 0.0 (Clear) to 1.0 (Opaque).
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Axis.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Axis.md
index 7b447918ff..9602b81676 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Axis.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Axis.md
@@ -6,17 +6,17 @@ control: XlsIO
documentation: UG
---
-# Chart Axis in Excel document
+# Chart Axis in an Excel document
Charts typically have two axes that are used to measure and categorize data.
-- Horizontal axis (also known as category axis or x axis).
-- Vertical axis (also known as value axis or y axis).
+- Horizontal axis (also known as category axis or x-axis).
+- Vertical axis (also known as value axis or y-axis).
-Using XlsIO, you can **customize the axis in the chart**.
+Using XlsIO, you can **customize the axis**.
-## Add
+## Set the Axis Title
-The following code snippet illustrates how to add the chart axis title.
+The following code snippet illustrates how to set the chart axis title.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -49,7 +49,7 @@ The following code snippet illustrates how to format the border of the chart axi
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Set the border
+//Set the border
chart.PrimaryCategoryAxis.Border.LinePattern = ExcelChartLinePattern.CircleDot;
chart.PrimaryCategoryAxis.Border.LineColor = Syncfusion.Drawing.Color.Blue;
chart.PrimaryCategoryAxis.Border.LineWeight = ExcelChartLineWeight.Hairline;
@@ -64,7 +64,7 @@ chart.SecondaryValueAxis.Border.LineWeight = ExcelChartLineWeight.Hairline;
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Set the border
+//Set the border
chart.PrimaryCategoryAxis.Border.LinePattern = ExcelChartLinePattern.CircleDot;
chart.PrimaryCategoryAxis.Border.LineColor = Syncfusion.Drawing.Color.Blue;
chart.PrimaryCategoryAxis.Border.LineWeight = ExcelChartLineWeight.Hairline;
@@ -79,7 +79,7 @@ chart.SecondaryValueAxis.Border.LineWeight = ExcelChartLineWeight.Hairline;
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Set the border
+'Set the border
chart.PrimaryCategoryAxis.Border.LinePattern = ExcelChartLinePattern.CircleDot
chart.PrimaryCategoryAxis.Border.LineColor = Syncfusion.Drawing.Color.Blue
chart.PrimaryCategoryAxis.Border.LineWeight = ExcelChartLineWeight.Hairline
@@ -285,9 +285,9 @@ chart.PrimaryValueAxis.HasMinorGridLines = False
{% endhighlight %}
{% endtabs %}
-### Max cross
+### Max Cross
-The following code snippet illustrates how to set the max cross in the chart axis.
+The following code snippet illustrates how to set the Max Cross in the chart axis.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -302,7 +302,7 @@ chart.SecondaryValueAxis.IsMaxCross = true;
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
'Set maxcross
-chart.SecondaryValueAxis.IsMaxCross = true
+chart.SecondaryValueAxis.IsMaxCross = True
{% endhighlight %}
{% endtabs %}
@@ -350,7 +350,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
chart.PrimaryValueAxis.Title = "Precipitation,in.";
chart.SecondaryValueAxis.Title = "Temperature,deg.F";
- //Set the border
+ //Set the border
chart.PrimaryCategoryAxis.Border.LinePattern = ExcelChartLinePattern.CircleDot;
chart.PrimaryCategoryAxis.Border.LineColor = Syncfusion.Drawing.Color.Blue;
chart.PrimaryCategoryAxis.Border.LineWeight = ExcelChartLineWeight.Hairline;
@@ -405,11 +405,11 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Showing major gridlines
chart.PrimaryValueAxis.HasMajorGridLines = true;
-
+
//Hiding minor gridlines
chart.PrimaryValueAxis.HasMinorGridLines = false;
- //Saving the workbook
+ //Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/Output.xlsx"));
}
{% endhighlight %}
@@ -428,7 +428,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
chart.PrimaryValueAxis.Title = "Precipitation,in.";
chart.SecondaryValueAxis.Title = "Temperature,deg.F";
- //Set the border
+ //Set the border
chart.PrimaryCategoryAxis.Border.LinePattern = ExcelChartLinePattern.CircleDot;
chart.PrimaryCategoryAxis.Border.LineColor = Syncfusion.Drawing.Color.Blue;
chart.PrimaryCategoryAxis.Border.LineWeight = ExcelChartLineWeight.Hairline;
@@ -483,7 +483,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Showing major gridlines
chart.PrimaryValueAxis.HasMajorGridLines = true;
-
+
//Hiding minor gridlines
chart.PrimaryValueAxis.HasMinorGridLines = false;
@@ -505,7 +505,7 @@ Using excelEngine As New ExcelEngine()
chart.PrimaryValueAxis.Title = "Precipitation,in."
chart.SecondaryValueAxis.Title = "Temperature,deg.F"
- 'Set the border
+ 'Set the border
chart.PrimaryCategoryAxis.Border.LinePattern = ExcelChartLinePattern.CircleDot
chart.PrimaryCategoryAxis.Border.LineColor = Syncfusion.Drawing.Color.Blue
chart.PrimaryCategoryAxis.Border.LineWeight = ExcelChartLineWeight.Hairline
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Data-Labels.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Data-Labels.md
index f091b8f205..9e836b1fc5 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Data-Labels.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Data-Labels.md
@@ -1,18 +1,18 @@
---
-title: Chart Data Label | Excel library | Syncfusion
-description: In this section, you can learn about chart data label in an Excel document with the .NET Excel Library.
+title: Chart Data Labels | Excel library | Syncfusion
+description: In this section, you can learn about chart data labels in an Excel document with the .NET Excel Library through clear explanations and practical examples.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Chart Data Labels in Excel document
+# Chart Data Labels in an Excel document
-Data Labels on a chart make it easier to understand. They show important information about the lines or points on the chart. Using XlsIO, you can **customize the data labels in the chart**.
+Data Labels on a chart make it easier to understand the chart. They show important information about the lines or points on the chart. Using XlsIO, you can **customize the data labels**.
## Add
-The following code snippet illustrates how to add the data label.
+The following code snippet illustrates how to add data labels. The `IsValue` property is one of several options; you can also set `IsCategoryName`, `IsSeriesName`, and `IsPercentage`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -31,9 +31,9 @@ chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.IsValue = True
{% endhighlight %}
{% endtabs %}
-### Add from the range of cells
+### Add from a Range of Cells
-The following code snippet illustrates how to add the data label from the range of cells.
+The following code snippet illustrates how to add data labels from a range of cells. This snippet assumes `worksheet` is an existing `IWorksheet`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -99,9 +99,9 @@ chart.Series[0].DataPoints.DefaultDataPoint.DataLabels.Bold = true;
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
'Set the font
-chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.Size = 10;
-chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.FontName = "calibri";
-chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.Bold = true;
+chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.Size = 10
+chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.FontName = "calibri"
+chart.Series(0).DataPoints.DefaultDataPoint.DataLabels.Bold = True
{% endhighlight %}
{% endtabs %}
@@ -190,7 +190,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IChartDataLabels dataLabel = chart.Series[0].DataPoints.DefaultDataPoint.DataLabels;
(dataLabel as ChartDataLabelsImpl).NumberFormat = "#,##0.00";
- //Saving the workbook
+ //Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/Output.xlsx"));
}
{% endhighlight %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Legend.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Legend.md
index 3a5c329c37..9b88586760 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Legend.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Legend.md
@@ -6,9 +6,9 @@ control: XlsIO
documentation: UG
---
-# Chart Legend in Excel document
+# Chart Legend in an Excel document
-Legends are visual pictorial hints that provide a viewer information that helps them understand an chart. Using XlsIO, you can **customize the legend in the chart**.
+Legends are visual pictorial hints that provide a viewer with information that helps them understand a chart. Using XlsIO, you can **customize the legend**.
## Add
@@ -102,7 +102,7 @@ chart.Legend.FrameFormat.Fill.ForeColorIndex = ExcelKnownColors.Yellow;
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
'Set the background color
-chart.Legend.FrameFormat.Fill.ForeColorIndex = ExcelKnownColors.Yellow;
+chart.Legend.FrameFormat.Fill.ForeColorIndex = ExcelKnownColors.Yellow
{% endhighlight %}
{% endtabs %}
@@ -201,21 +201,21 @@ chart.Legend.IncludeInLayout = true
## Remove
-The following code snippet illustrates how to remove the legend.
+The following code snippet illustrates how to remove a single legend entry from the chart. Repeat the call for each entry you want to remove. To hide the entire legend instead, set `chart.HasLegend = false;`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Remove the legend
+//Remove the first legend entry
chart.Legend.LegendEntries[0].Delete();
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Remove the legend
+//Remove the first legend entry
chart.Legend.LegendEntries[0].Delete();
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Remove the legend
+'Remove the first legend entry
chart.Legend.LegendEntries(0).Delete()
{% endhighlight %}
{% endtabs %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Plot-Area.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Plot-Area.md
index 252efbbcf0..a306f38198 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Plot-Area.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Plot-Area.md
@@ -6,13 +6,13 @@ control: XlsIO
documentation: UG
---
-# Chart Plot Area in Excel document
+# Chart Plot Area in an Excel document
-The plot area refers to the region that represents the plotted data in a chart. Using XlsIO, you can **customize the plot area in the chart**.
+The plot area refers to the region that represents the plotted data in a chart. Using XlsIO, you can **customize the plot area**.
## Formatting
-### Border
+### Border
The following code snippet illustrates how to format the border of the plot area.
@@ -80,7 +80,7 @@ chartPlotArea.Fill.ForeColor = Color.White
### Transparency
-The following code snippet illustrates how to apply transparency in the plot area.
+The following code snippet illustrates how to apply transparency to the plot area. This snippet assumes `chartPlotArea` is already initialized from the [Border](#border) or [Color](#color) example.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -89,21 +89,21 @@ chartPlotArea.Fill.Transparency = 0.5;
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Set the transparency
+//Set the transparency
chartPlotArea.Fill.Transparency = 0.5;
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Set the transparency
+'Set the transparency
chartPlotArea.Fill.Transparency = 0.5
{% endhighlight %}
{% endtabs %}
-N> [Transparency](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_Transparency) is only applicable when [FillType](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_FillType) is set as SolidColor. Color-shaded fill is represented as a floating-point value ranging from 0.0 (Clear) to 1.0 (Opaque).
+N> [Transparency](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_Transparency) is only applicable when [FillType](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_FillType) is set as SolidColor. The value is a floating-point number ranging from 0.0 (Clear) to 1.0 (Opaque).
-## Set position
+## Set the Position
-The following code snippet illustrates how to set the position of the plot area.
+The following code snippet illustrates how to set the position of the plot area. This snippet assumes `chartPlotArea` is already initialized from the [Border](#border) or [Color](#color) example.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -117,8 +117,8 @@ chartPlotArea.Layout.Left = 5;
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Set the position
-chartPlotArea.Layout.Left = 5;
+'Set the position
+chartPlotArea.Layout.Left = 5
{% endhighlight %}
{% endtabs %}
@@ -151,7 +151,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Set the position
chartPlotArea.Layout.Left = 5;
- //Saving the workbook
+ //Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/Output.xlsx"));
}
{% endhighlight %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Series.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Series.md
index e2708dda95..33babaa11a 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Series.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Series.md
@@ -6,38 +6,38 @@ control: XlsIO
documentation: UG
---
-# Chart Series in Excel document
+# Chart Series in an Excel document
-In a chart, a **series** represents a set of related data points, often depicted using lines, bars, or markers to show data trends or comparisons. Using XlsIO, you can **customize the series in the chart**.
+In a chart, a **series** represents a set of related data points, often depicted using lines, bars, or markers to show data trends or comparisons. Using XlsIO, you can **customize the series**.
## Add
-The following code snippet illustrates how to add series in chart.
+The following code snippet illustrates how to add a series to a chart. Series are zero-indexed, so the first series is `Series[0]`. This snippet assumes `chart` is an existing `IChartShape` and `worksheet` is an existing `IWorksheet`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
//Add series
-IChartSerie Amount = chart.Series.Add("Amount");
-Amount.Values = worksheet.Range["B2:B6"];
-Amount.CategoryLabels = worksheet.Range["A2:A6"];
+IChartSerie amount = chart.Series.Add("Amount");
+amount.Values = worksheet.Range["B2:B6"];
+amount.CategoryLabels = worksheet.Range["A2:A6"];
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
//Add series
-IChartSerie Amount = chart.Series.Add("Amount");
-Amount.Values = worksheet.Range["B2:B6"];
-Amount.CategoryLabels = worksheet.Range["A2:A6"];
+IChartSerie amount = chart.Series.Add("Amount");
+amount.Values = worksheet.Range["B2:B6"];
+amount.CategoryLabels = worksheet.Range["A2:A6"];
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
'Add series
-IChartSerie Amount = chart.Series.Add("Amount")
-Amount.Values = worksheet.Range["B2:B6"]
-Amount.CategoryLabels = worksheet.Range["A2:A6"]
+Dim amount As IChartSerie = chart.Series.Add("Amount")
+amount.Values = worksheet.Range("B2:B6")
+amount.CategoryLabels = worksheet.Range("A2:A6")
{% endhighlight %}
{% endtabs %}
-## Format
+## Formatting
### Border
@@ -59,7 +59,7 @@ chart.Series[1].SerieFormat.LineProperties.LineWeight = ExcelChartLineWeight.Nar
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-' Set the border
+'Set the border
chart.Series(1).SerieFormat.LineProperties.LineColor = Color.Red
chart.Series(1).SerieFormat.LineProperties.LinePattern = ExcelChartLinePattern.Dot
chart.Series(1).SerieFormat.LineProperties.LineWeight = ExcelChartLineWeight.Narrow
@@ -107,17 +107,17 @@ chart.Series[1].SerieFormat.Fill.Transparency = 1.0;
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Set the transparency
+//Set the transparency
chart.Series[1].SerieFormat.Fill.Transparency = 1.0;
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Set the transparency
+'Set the transparency
chart.Series(1).SerieFormat.Fill.Transparency = 1.0
{% endhighlight %}
{% endtabs %}
-N> [Transparency](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_Transparency) is only applicable when [FillType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_FillType) is set as SolidColor. Color-shaded fill is represented as a floating-point value ranging from 0.0 (Clear) to 1.0 (Opaque).
+N> [Transparency](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_Transparency) is only applicable when [FillType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IFill.html#Syncfusion_XlsIO_IFill_FillType) is set as SolidColor. The value is a floating-point number ranging from 0.0 (Clear) to 1.0 (Opaque).
## Series Type
@@ -339,9 +339,9 @@ A complete working example for the chart data series in C# is present on [this G
## Series Settings
-### Add DataPoint as total
+### Mark a Data Point as Total
-The following code snippet illustrates how to add the Data Point as total in chart.
+The following code snippet illustrates how to mark a data point as total in a chart.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -360,9 +360,9 @@ chart.Series(0).DataPoints(3).SetAsTotal = True
{% endhighlight %}
{% endtabs %}
-### Add Connector lines between data points
+### Add Connector Lines Between Data Points
-The following code snippet illustrates how to add the connector lines between data points.
+The following code snippet illustrates how to add the connector lines between data points.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -381,11 +381,11 @@ chart.Series(0).SerieFormat.ShowConnectorLines = True
{% endhighlight %}
{% endtabs %}
-### Add space between bars
+### Add Space Between Bars
Spaces between chart bars are of two types.
-1. **Series Overlap** : Space between bars of different data series of single category.
+1. **Series Overlap** : Space between bars of different data series of a single category.
2. **Gap Width** : Space between different categories.
XlsIO allows you to adjust the space between chart bars using [Overlap](https://help.syncfusion.com/cr/windowsforms/Syncfusion.XlsIO.IChartFormat.html#Syncfusion_XlsIO_IChartFormat_Overlap) and [GapWidth](https://help.syncfusion.com/cr/windowsforms/Syncfusion.XlsIO.IChartFormat.html#Syncfusion_XlsIO_IChartFormat_GapWidth) properties of [IChartFormat](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IChartFormat.html) interface.
@@ -394,7 +394,7 @@ The following code snippet illustrates how to add space between bars.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/Chart%20Bars%20Spacing/.NET/Chart%20Bars%20Spacing/Chart%20Bars%20Spacing/Program.cs,180" %}
-//Adding space between bars of different series of single category.
+//Adding space between bars of different series of a single category.
chart.Series[0].SerieFormat.CommonSerieOptions.Overlap = 60;
//Adding space between bars of different categories.
@@ -402,7 +402,7 @@ chart.Series[0].SerieFormat.CommonSerieOptions.GapWidth = 80;
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Adding space between bars of different series of single category.
+//Adding space between bars of different series of a single category.
chart.Series[0].SerieFormat.CommonSerieOptions.Overlap = 60;
//Adding space between bars of different categories.
@@ -489,7 +489,7 @@ chart.Series(0).SerieFormat.CommonSerieOptions.HasDropLines = True
'Apply formats to DropLines.
chart.Series(0).SerieFormat.CommonSerieOptions.DropLines.LineColor = Color.Red
-chart.Series(0).SerieFormat.CommonSerieOptions.DropLines.LinePattern = ExcelChartLinePattern.Dot;
+chart.Series(0).SerieFormat.CommonSerieOptions.DropLines.LinePattern = ExcelChartLinePattern.Dot
chart.Series(0).SerieFormat.CommonSerieOptions.DropLines.LineWeight = ExcelChartLineWeight.Narrow
{% endhighlight %}
{% endtabs %}
@@ -498,7 +498,7 @@ A complete working example to add drop lines of chart in C# is present on [this
### Add Series Lines
-The following code snippet illustrates how to add series lines in chart.
+The following code snippet illustrates how to add series lines to a chart.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Create%20and%20Edit%20Charts/Series%20Lines/.NET/Series%20Lines/Series%20Lines/Program.cs,180" %}
@@ -523,7 +523,7 @@ chart.Series[0].SerieFormat.CommonSerieOptions.PieSeriesLine.LineWeight = ExcelC
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
'Set HasSeriesLines property to true
-chart.Series(0).SerieFormat.CommonSerieOptions.HasSeriesLines = true
+chart.Series(0).SerieFormat.CommonSerieOptions.HasSeriesLines = True
'Apply formats to SeriesLines
chart.Series(0).SerieFormat.CommonSerieOptions.PieSeriesLine.LineColor = Color.Red
diff --git a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Title.md b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Title.md
index 434de237a4..a5b7b1c36d 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Title.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Charts/Chart-Title.md
@@ -6,9 +6,9 @@ control: XlsIO
documentation: UG
---
-# Chart Title in Excel document
+# Chart Title in an Excel document
-Chart title is a brief description at the top of a chart, offering context and clarity for the data displayed. Using XlsIO, you can **customize the chart title in the chart**.
+Chart title is a brief description at the top of a chart, offering context and clarity for the data displayed. Using XlsIO, you can **customize the chart title**.
## Add
@@ -16,20 +16,17 @@ The following code snippet illustrates how to add the chart title.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Set chart name and title
-chart.Name = "Purchase Details";
+//Set the chart title
chart.ChartTitle = "Purchase Details";
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Set chart name and title
-chart.Name = "Purchase Details";
+//Set the chart title
chart.ChartTitle = "Purchase Details";
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Set chart name and title
-chart.Name = "Purchase Details"
+'Set the chart title
chart.ChartTitle = "Purchase Details"
{% endhighlight %}
{% endtabs %}
@@ -38,7 +35,7 @@ chart.ChartTitle = "Purchase Details"
### Color
-The following code snippet illustrates how to format the color of the chart area.
+The following code snippet illustrates how to format the color of the chart title.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -59,7 +56,7 @@ chart.ChartTitleArea.Color = ExcelKnownColors.Black
### Font
-The following code snippet illustrates how to format the font of the legend.
+The following code snippet illustrates how to format the font of the chart title.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -144,12 +141,11 @@ using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
application.DefaultVersion = ExcelVersion.Xlsx;
- IWorkbook workbook = application.Workbooks.Open("InputTemplate.xlsx");
+ IWorkbook workbook = application.Workbooks.Open("InputTemplate.xlsx", ExcelOpenType.Automatic);
IWorksheet sheet = workbook.Worksheets[0];
IChartShape chart = sheet.Charts[0];
- //Set chart name and title
- chart.Name = "Purchase Details";
+ //Set the chart title
chart.ChartTitle = "Purchase Details";
//Set the color
@@ -174,12 +170,11 @@ Using excelEngine As New ExcelEngine()
Dim application As IApplication = excelEngine.Excel
application.DefaultVersion = ExcelVersion.Xlsx
- Dim workbook As IWorkbook = application.Workbooks.Open("InputTemplate.xlsx")
+ Dim workbook As IWorkbook = application.Workbooks.Open("InputTemplate.xlsx", ExcelOpenType.Automatic)
Dim sheet As IWorksheet = workbook.Worksheets(0)
Dim chart As IChartShape = sheet.Charts(0)
- 'Set chart name and title
- chart.Name = "Purchase Details"
+ 'Set the chart title
chart.ChartTitle = "Purchase Details"
'Set the color
@@ -191,10 +186,10 @@ Using excelEngine As New ExcelEngine()
chart.ChartTitleArea.Underline = ExcelUnderline.Single
chart.ChartTitleArea.Size = 15
- 'Set the position of
+ 'Set the position of the chart title
chart.ChartTitleArea.Layout.Left = 20
- 'Saving the workbook as stream
+ 'Saving the workbook
workbook.SaveAs("Output.xlsx")
End Using
{% endhighlight %}
@@ -204,11 +199,11 @@ A complete working example for the chart title in C# is present on [this GitHub
## Remove
-The following code snippet illustrates how to remove the chart title.
+The following code snippet illustrates how to remove the chart title by clearing its text. The title frame is preserved but rendered without any text.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Remove the chart title
+//Remove the chart title
chart.ChartTitleArea.Text = String.Empty;
{% endhighlight %}
@@ -218,7 +213,7 @@ chart.ChartTitleArea.Text = String.Empty;
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Remove the chart title
+'Remove the chart title
chart.ChartTitleArea.Text = String.Empty
{% endhighlight %}
{% endtabs %}
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Color-Scales.md b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Color-Scales.md
index c11fffbb01..1c0d7c4399 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Color-Scales.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Color-Scales.md
@@ -1,6 +1,6 @@
---
title: Color Scales | Excel library | Syncfusion
-description: In this section, you can learn how to apply color scales using conditional formatting in an Excel document with XlsIO
+description: Learn how to apply color-scale conditional formatting rules in an Excel document using Syncfusion XlsIO.
platform: document-processing
control: XlsIO
documentation: UG
@@ -8,11 +8,19 @@ documentation: UG
# Color Scales in Conditional Formatting
-Color Scales let you create visual effects in your data to see how the value of a cell is compared with the values in a range of cells. A color scale uses cell shading, as opposed to bars, to communicate relative values, beyond the relative size of the value of a cell.
+Color scales apply cell shading to visually indicate how the value of a cell compares to the other values in a range. Unlike data bars, color scales use cell background color rather than an embedded bar to communicate relative values.
-The following code example illustrates how to apply color scales using [IColorScale](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IColorScale.html) interface in XlsIO.
+The following code example illustrates how to apply color scales using the [IColorScale](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IColorScale.html) interface in XlsIO. Key members are:
-{% tabs %}
+* **SetConditionCount** – sets the number of colors in the scale; XlsIO supports 2-color and 3-color scales.
+* **Criteria** – an array of ColorScaleCriteria(length 2 or 3), one for each color in the scale.
+* **FormatColorRGB** (on each criterion) – the color used when the criterion is met.
+* **Type** (on each criterion) – the [ConditionValueType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ConditionValueType.html) that defines how the criterion's threshold is interpreted: `LowestValue`, `HighestValue`, `Percent`, `Percentile`, `Number`, or `Formula`.
+* **Value** (on each criterion) – the threshold value, required when **Type** is `Percent`, `Percentile`, `Number`, or `Formula`; ignored when **Type** is `LowestValue` or `HighestValue`.
+
+N> Color-scale conditional formatting is supported in Excel 2007 and later formats (`.xlsx`, `.xlsm`).
+
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Color%20Scales/.NET/Color%20Scales/Color%20Scales/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -27,7 +35,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
conditionalFormat.FormatType = ExcelCFType.ColorScale;
IColorScale colorScale = conditionalFormat.ColorScale;
- //Sets 3 - color scale
+ //Set a 3-color scale
colorScale.SetConditionCount(3);
colorScale.Criteria[0].FormatColorRGB = Color.FromArgb(230, 197, 218);
colorScale.Criteria[0].Type = ConditionValueType.LowestValue;
@@ -60,7 +68,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
conditionalFormat.FormatType = ExcelCFType.ColorScale;
IColorScale colorScale = conditionalFormat.ColorScale;
- //Sets 3 - color scale
+ //Set a 3-color scale
colorScale.SetConditionCount(3);
colorScale.Criteria[0].FormatColorRGB = Color.FromArgb(230, 197, 218);
colorScale.Criteria[0].Type = ConditionValueType.LowestValue;
@@ -90,7 +98,7 @@ Using excelEngine As New ExcelEngine()
conditionalFormat.FormatType = ExcelCFType.ColorScale
Dim colorScale As IColorScale = conditionalFormat.ColorScale
- ' Sets 3 - color scale
+ ' Set a 3-color scale
colorScale.SetConditionCount(3)
colorScale.Criteria(0).FormatColorRGB = Color.FromArgb(230, 197, 218)
colorScale.Criteria(0).Type = ConditionValueType.LowestValue
diff --git a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Data-Bars.md b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Data-Bars.md
index 0d37eea873..e123ade68c 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Data-Bars.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Data-Bars.md
@@ -1,6 +1,6 @@
---
title: Data Bars | Excel library | Syncfusion
-description: In this section, you can learn how to apply data bars using conditional formatting in an Excel document with XlsIO
+description: Learn how to apply data-bar conditional formatting rules in an Excel document using Syncfusion XlsIO.
platform: document-processing
control: XlsIO
documentation: UG
@@ -8,11 +8,21 @@ documentation: UG
# Data Bars in Conditional Formatting
-Here, the values in each of the selected cells are compared, and a data bar is drawn in each cell representing the value of that cell relative to the other cells in the selected range. This bar provides a clear visual cue for users, making it easier to pick out larger and smaller values in a range.
+Data bars draw a horizontal bar in each cell whose length represents the value of that cell relative to the other cells in the selected range. This provides a clear visual cue that makes it easier to compare larger and smaller values at a glance.
-The following code example illustrates how to apply data bars using [IDataBar](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IDataBar.html) interface in XlsIO.
+The following code example illustrates how to apply data bars using the [IDataBar](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IDataBar.html) interface in XlsIO. Key members of **IDataBar** include:
-{% tabs %}
+* **BarColor** – sets the fill color of the bar.
+* **ShowValue** – when `true` (the default), the cell value is displayed; when `false`, only the bar is shown.
+* **MinLength** / **MaxLength** – the bar length as a percentage of the cell width (defaults are 10 and 90).
+* **BarOnly** – when `true`, hides the cell value and shows only the bar.
+* **BarBorder** – the [IBorder](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IBorder.html) applied to the data bar.
+* **BarDirection** – the direction of the bar (`ExcelDataBarDirection.Context` for the default left-to-right).
+* **NegativeBarColor** – the color used for negative values.
+
+N> Data-bar conditional formatting is supported in Excel 2007 and later formats (`.xlsx`, `.xlsm`).
+
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Data%20Bars/.NET/Data%20Bars/Data%20Bars/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -27,7 +37,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
conditionalFormat.FormatType = ExcelCFType.DataBar;
IDataBar dataBar = conditionalFormat.DataBar;
- //Set color for Bar
+ //Set color for the bar
dataBar.BarColor = Color.Aqua;
//Hide the values in data bar
@@ -54,7 +64,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
conditionalFormat.FormatType = ExcelCFType.DataBar;
IDataBar dataBar = conditionalFormat.DataBar;
- //Set color for Bar
+ //Set color for the bar
dataBar.BarColor = Color.Aqua;
//Hide the values in data bar
@@ -78,7 +88,7 @@ Using excelEngine As New ExcelEngine()
conditionalFormat.FormatType = ExcelCFType.DataBar
Dim dataBar As IDataBar = conditionalFormat.DataBar
- ' Set color for Bar
+ ' Set color for the bar
dataBar.BarColor = Color.Aqua
' Hide the values in data bar
diff --git a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Highlight-Cells.md b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Highlight-Cells.md
index 8ffceb6e93..4a9e0da9fa 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Highlight-Cells.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Highlight-Cells.md
@@ -1,6 +1,6 @@
---
-title: Highlight Cells| Excel library | Syncfusion
-description: In this section, you can learn how to apply highlight cells using conditional formatting in an Excel document with XlsIO
+title: Highlight Cells | Excel library | Syncfusion
+description: Learn how to apply highlight-cell conditional formatting rules in an Excel document using Syncfusion XlsIO.
platform: document-processing
control: XlsIO
documentation: UG
@@ -8,20 +8,20 @@ documentation: UG
# Highlight Cells in Conditional Formatting
-Highlight cell rules are powerful tools for data analysis and presentation, enhancing the ability to quickly interpret and act upon data within worksheets.
+Highlight-cell rules are conditional formatting rules that visually emphasize cells in a worksheet based on their values. They help you quickly interpret and act upon data.
## Format Unique and Duplicate Values
-Format unique and duplicate values of an Excel range using conditional formatting. The values, **Unique** and **Duplicate** of the enumeration [ExcelCFType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelCFType.html) helps to achieve the requirement.
+You can highlight unique and duplicate values within an Excel range by setting the [FormatType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IConditionalFormat.html#Syncfusion_XlsIO_IConditionalFormat_FormatType) of an [IConditionalFormat](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IConditionalFormat.html) to `ExcelCFType.Unique` or `ExcelCFType.Duplicate` from the [ExcelCFType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelCFType.html) enumeration. The `Unique` value applies the rule only to values that appear once in the range, while `Duplicate` applies the rule to values that appear more than once.
The following code example illustrates how to format unique and duplicate values using conditional formatting.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Unique%20and%20Duplicate/.NET/Unique%20and%20Duplicate/Unique%20and%20Duplicate/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
- application.DefaultVersion = ExcelVersion.Excel2016;
+ application.DefaultVersion = ExcelVersion.Xlsx;
IWorkbook workbook = application.Workbooks.Create(1);
IWorksheet worksheet = workbook.Worksheets[0];
@@ -84,7 +84,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
worksheet.Range["A4:B21"].ConditionalFormats;
IConditionalFormat condition = conditionalFormats.AddCondition();
- //conditional format to set duplicate format type
+ //Conditional format to set duplicate format type
condition.FormatType = ExcelCFType.Duplicate;
condition.BackColorRGB = Color.FromArgb(255, 255, 199, 206);
@@ -170,10 +170,10 @@ using (ExcelEngine excelEngine = new ExcelEngine())
worksheet.Range["C14"].Number = 300;
worksheet.Range["C15"].Number = 550;
worksheet.Range["C16"].Number = 700;
- worksheet.Range["C17"].Number = 610;
- worksheet.Range["C18"].Number = 750;
- worksheet.Range["C19"].Number = 500;
- worksheet.Range["C20"].Number = 750;
+ worksheet.Range["C17"].Number = 610;
+ worksheet.Range["C18"].Number = 750;
+ worksheet.Range["C19"].Number = 500;
+ worksheet.Range["C20"].Number = 750;
worksheet.Range["C21"].Number = 910;
worksheet.SetColumnWidth(1, 23.45);
@@ -315,6 +315,6 @@ End Using
A complete working example to format unique and duplicate values in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Conditional%20Formatting/Unique%20and%20Duplicate/.NET/Unique%20and%20Duplicate).
-By executing the program, you will get the Excel file as below
+By executing the program, you will get the Excel file as shown below.
-.
\ No newline at end of file
+
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Icon-Sets.md b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Icon-Sets.md
index 4aad64be00..2b1bf0b44d 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Icon-Sets.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Icon-Sets.md
@@ -1,6 +1,6 @@
---
title: Icon Sets | Excel library | Syncfusion
-description: In this section, you can learn how to apply Icon sets uisng conditional formatting in an Excel document with XlsIO
+description: Learn how to apply icon-set conditional formatting rules in an Excel document using Syncfusion XlsIO.
platform: document-processing
control: XlsIO
documentation: UG
@@ -8,11 +8,18 @@ documentation: UG
# Icon Sets in Conditional Formatting
-Icon sets present data in three to five categories that are distinguished by a threshold value. Each icon represents a range of values and each cell is annotated with the icon that represents that range.
+Icon sets annotate each cell with an icon chosen from three to five categories that are distinguished by threshold values. Each icon represents a range of values, and each cell is annotated with the icon whose range contains the cell value.
-The following code example illustrates how to apply Icon sets using [IconSet](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconSet.html) interface in XlsIO.
+The following code example illustrates how to apply icon sets using the [IIconSet](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconSet.html) interface in XlsIO. Key members are:
-{% tabs %}
+* **IconSet** – selects the icon family using the [ExcelIconSetType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelIconSetType.html) enumerator (for example, `ThreeSymbols`, `ThreeFlags`, `ThreeSigns`, `FourRating`, `FiveBoxes`).
+* **IconCriteria** – the array of IIconCriteria (3, 4, or 5 entries depending on the icon family) that defines each icon's threshold.
+* **ShowIconOnly** – when `true`, hides the cell value and shows only the icon.
+* **ReverseIconOrder** – when `true`, reverses the order in which the icons are assigned.
+
+N> Icon-set conditional formatting is supported in Excel 2007 and later formats (`.xlsx`, `.xlsm`).
+
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Icon%20Sets/.NET/Icon%20Sets/Icon%20Sets/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -27,7 +34,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
conditionalFormat.FormatType = ExcelCFType.IconSet;
IIconSet iconSet = conditionalFormat.IconSet;
- //Apply three symbols icon and hide the data in the specified range
+ //Apply a three-symbol icon set and hide the cell values
iconSet.IconSet = ExcelIconSetType.ThreeSymbols;
iconSet.IconCriteria[1].Type = ConditionValueType.Percent;
iconSet.IconCriteria[1].Value = "50";
@@ -56,7 +63,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
conditionalFormat.FormatType = ExcelCFType.IconSet;
IIconSet iconSet = conditionalFormat.IconSet;
- //Apply three symbols icon and hide the data in the specified range
+ //Apply a three-symbol icon set and hide the cell values
iconSet.IconSet = ExcelIconSetType.ThreeSymbols;
iconSet.IconCriteria[1].Type = ConditionValueType.Percent;
iconSet.IconCriteria[1].Value = "50";
@@ -82,7 +89,7 @@ Using excelEngine As New ExcelEngine()
conditionalFormat.FormatType = ExcelCFType.IconSet
Dim iconSet As IIconSet = conditionalFormat.IconSet
- ' Apply three symbols icon and hide the data in the specified range
+ ' Apply a three-symbol icon set and hide the cell values
iconSet.IconSet = ExcelIconSetType.ThreeSymbols
iconSet.IconCriteria(1).Type = ConditionValueType.Percent
iconSet.IconCriteria(1).Value = "50"
@@ -100,11 +107,11 @@ A complete working example to apply Icon sets in C# is present on [this GitHub p
## Custom Icon Sets
-You can customize the icon set by changing the [IconSet](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconConditionValue.html#Syncfusion_XlsIO_IIconConditionValue_IconSet) and [Index](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconConditionValue.html#Syncfusion_XlsIO_IIconConditionValue_Index) properties for each icon criteria.
+You can customize the icon set by changing the [IconSet](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconConditionValue.html#Syncfusion_XlsIO_IIconConditionValue_IconSet), [Index](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconConditionValue.html#Syncfusion_XlsIO_IIconConditionValue_Index), and [Operator](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconConditionValue.html#Syncfusion_XlsIO_IIconConditionValue_Operator) properties of each icon criterion. To access these properties, cast each `IconCriteria` entry to [IIconConditionValue](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IIconConditionValue.html). The **Index** is the zero-based position of the icon within the selected **IconSet** family (for example, `Index = 0` selects the first icon in that family, `Index = 3` the fourth).
-Custom Icon sets can be created and customized in XlsIO as follows.
+Custom icon sets can be created and customized in XlsIO as follows.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
// Create icon sets for the data in specified range
IConditionalFormats conditionalFormats = sheet.Range["H1:K6"].ConditionalFormats;
@@ -167,32 +174,32 @@ iconValue3.Operator = ConditionalFormatOperator.GreaterThan;
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
Dim conditionalFormats As IConditionalFormats = sheet.Range("H1:K6").ConditionalFormats
-Dim conditionalFormat As IConditionalFormat = conditionalFormats.AddCondition
+Dim conditionalFormat As IConditionalFormat = conditionalFormats.AddCondition()
conditionalFormat.FormatType = ExcelCFType.IconSet
Dim iconSet As IIconSet = conditionalFormat.IconSet
iconSet.IconSet = ExcelIconSetType.ThreeFlags
-Dim iconValue1 As IIconConditionValue = CType(iconSet.IconCriteria(0),IIconConditionValue)
+Dim iconValue1 As IIconConditionValue = CType(iconSet.IconCriteria(0), IIconConditionValue)
iconValue1.IconSet = ExcelIconSetType.FiveBoxes
iconValue1.Index = 3
iconValue1.Type = ConditionValueType.Percent
iconValue1.Value = "25"
iconValue1.Operator = ConditionalFormatOperator.GreaterThan
-Dim iconValue2 As IIconConditionValue = CType(iconSet.IconCriteria(1),IIconConditionValue)
+Dim iconValue2 As IIconConditionValue = CType(iconSet.IconCriteria(1), IIconConditionValue)
iconValue2.IconSet = ExcelIconSetType.ThreeSigns
iconValue2.Index = 2
iconValue2.Type = ConditionValueType.Percent
iconValue2.Value = "50"
iconValue2.Operator = ConditionalFormatOperator.GreaterThan
-Dim iconValue3 As IIconConditionValue = CType(iconSet.IconCriteria(2),IIconConditionValue)
+Dim iconValue3 As IIconConditionValue = CType(iconSet.IconCriteria(2), IIconConditionValue)
iconValue3.IconSet = ExcelIconSetType.FourRating
iconValue3.Index = 0
iconValue3.Type = ConditionValueType.Percent
iconValue3.Value = "75"
iconValue3.Operator = ConditionalFormatOperator.GreaterThan
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
-N> XlsIO visualization has been enhanced with backward compatibility for Advanced Conditional Formatting.
\ No newline at end of file
+N> The custom icon-set feature is available in newer XlsIO versions with backward compatibility for advanced conditional formatting.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Top-Bottom.md b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Top-Bottom.md
index 6f9a024be4..f742804ad5 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Top-Bottom.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Conditional-Formatting/Top-Bottom.md
@@ -1,6 +1,6 @@
---
title: Top/Bottom | Excel library | Syncfusion
-description: In this section, you can learn how to apply top/bottom rules using conditional formatting in an Excel document with XlsIO
+description: Learn how to apply top/bottom, above/below average, and standard deviation conditional formatting rules using Syncfusion XlsIO.
platform: document-processing
control: XlsIO
documentation: UG
@@ -8,23 +8,23 @@ documentation: UG
# Top/Bottom in Conditional Formatting
-Top/Bottom Rules are powerful tools for data analysis and presentation, enhancing the ability to quickly identify and emphasize the highest or lowest values within a range of cells in a worksheet.
+Top/Bottom rules are conditional formatting rules that help you quickly identify and emphasize the highest or lowest values within a range of cells in a worksheet.
## Format Top or Bottom Values
-Top/Bottom rule in conditional formatting is used to highlight the top or bottom ranked cells in a data range. Top/Bottom conditional formatting rule can be created and customized using the [ITopBottom](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html) interface in XlsIO.
+The Top/Bottom rule highlights the top or bottom ranked cells in a data range. A Top/Bottom conditional formatting rule is created and customized using the [ITopBottom](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html) interface in XlsIO.
-The properties of **ITopBottom** interface are:
+The properties of the **ITopBottom** interface are:
-* **Type** - Specifies whether the rank is evaluated from the top or bottom.
-* **Percent** - Specifies whether the rank is determined by a percentage value.
-* **Rank** - Specifies the maximum number or percentage of cells to be highlighted.
+* **Type** – Specifies whether the rank is evaluated from the top or bottom, using the `ExcelCFTopBottomType` enumerator (`Top` or `Bottom`).
+* **Percent** – Specifies whether the **Rank** value is treated as a percentage of the range (`true`) or as an absolute number of cells (`false`).
+* **Rank** – Specifies the maximum number (or percentage) of cells to be highlighted.
-### Top/Bottom ‘n’ rank values
+### Top/Bottom ‘n’ Rank Values
-The following code example illustrates how to format top 10 rank values from the given data range using [ITopBottom](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html) [Type](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Type) and [Rank](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Rank) properties in XlsIO.
+The following code example illustrates how to format the top 10 rank values from the given data range using the [ITopBottom](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html) [Type](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Type) and [Rank](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Rank) properties in XlsIO.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Top%20to%20Bottom%20Rank/.NET/Top%20to%20Bottom%20Rank/Top%20to%20Bottom%20Rank/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -63,7 +63,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IApplication application = excelEngine.Excel;
application.DefaultVersion = ExcelVersion.Xlsx;
- IWorkbook workbook = workbook = application.Workbooks.Open("InputTemplate.xlsx");
+ IWorkbook workbook = application.Workbooks.Open("InputTemplate.xlsx");
IWorksheet worksheet = workbook.Worksheets[0];
//Applying conditional formatting to "N6:N35".
@@ -167,17 +167,17 @@ End Using
A complete working example to format top and bottom rank values in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Conditional%20Formatting/Top%20to%20Bottom%20Rank/.NET/Top%20to%20Bottom%20Rank).
-By executing the program, you will get the Excel file as below
+By executing the program, you will get the Excel file as shown below.
-N> **ITopBottom** **Rank** value should be in a range between 1 and 1000.
+N> The **ITopBottom** **Rank** value should be in a range between 1 and 1000.
-### Top/Bottom ‘n’% rank values
+### Top/Bottom ‘n’% Rank Values
-The following code example illustrates how to format top 50 percentage rank values from the given data range using [ITopBottom](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html) [Type](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Type), [Rank](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Rank) and [Percent](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Percent) properties in XlsIO
+The following code example illustrates how to format the bottom 50 percent of rank values from the given data range using the [ITopBottom](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html) [Type](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Type), [Rank](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Rank), and [Percent](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ITopBottom.html#Syncfusion_XlsIO_ITopBottom_Percent) properties in XlsIO.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Top%20To%20Bottom%20Percent/.NET/Top%20To%20Bottom%20Percent/Top%20To%20Bottom%20Percent/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -335,20 +335,20 @@ By executing the program, you will get the Excel file as below
-N> **ITopBottom** **Rank** value should be in a range between 1 and 100 when set true to **Percent** property.
+N> The **ITopBottom** **Rank** value should be in a range between 1 and 100 when **Percent** is set to `true`.
## Format Above or Below Average Values
-Above/Below average rule in conditional formatting is used to highlight the cells which contains above/below the average values in a data range. Top/Bottom conditional formatting rule can be created and customized using the [IAboveBelowAverage](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html) interface in XlsIO.
+The Above/Below Average rule highlights cells that contain values above or below the average of a data range. An Above/Below Average conditional formatting rule is created and customized using the [IAboveBelowAverage](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html) interface in XlsIO.
The properties of **IAboveBelowAverage** are:
-* **AverageType** - Specifies whether the conditional formatting rule looks for cell values that are above average or below average or standard deviation.
-* **StdDevValue** - Specifies standard deviation number for **AboveBelowAverage** conditional formatting rule.
+* **AverageType** – Specifies the type of rule, using the `ExcelCFAverageType` enumerator: `Above`, `Below`, `AboveStdDev`, `BelowStdDev`, `EqualOrAboveStdDev`, or `EqualOrBelowStdDev`.
+* **StdDevValue** – Specifies the standard deviation number used when **AverageType** is one of the standard deviation values.
-The following code example illustrates shows how to format a range with values that are below average using **IAboveBelowAverage** [AverageType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html#Syncfusion_XlsIO_IAboveBelowAverage_AverageType) property in XlsIO.
+The following code example illustrates how to format a range with values that are below average using the **IAboveBelowAverage** [AverageType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html#Syncfusion_XlsIO_IAboveBelowAverage_AverageType) property in XlsIO.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Above%20and%20Below%20Average/.NET/Above%20and%20Below%20Average/Above%20and%20Below%20Average/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -384,7 +384,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
application.DefaultVersion = ExcelVersion.Excel2013;
- IWorkbook workbook = workbook = application.Workbooks.Open("CFTemplate.xlsx");
+ IWorkbook workbook = application.Workbooks.Open("CFTemplate.xlsx");
IWorksheet worksheet = workbook.Worksheets[0];
//Applying conditional formatting to "M6:M35"
@@ -403,7 +403,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
format.BackColorRGB = System.Drawing.Color.FromArgb(166, 59, 38);
//Saves the Excel
- workbook.SaveAs("AboveBelowAverage.xlsx");
+ workbook.SaveAs("AboveBelowAverage.xlsx");
}
{% endhighlight %}
@@ -415,19 +415,19 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
Dim worksheet As IWorksheet = workbook.Worksheets(0)
'Applying conditional formatting to "M6:M35"
- IConditionalFormats formats = worksheet.Range["M6:M35"].ConditionalFormats;
- IConditionalFormat format = formats.AddCondition();
+ Dim formats As IConditionalFormats = worksheet.Range("M6:M35").ConditionalFormats
+ Dim format As IConditionalFormat = formats.AddCondition()
'Applying above or below average rule in the conditional formatting
- format.FormatType = ExcelCFType.AboveBelowAverage;
- IAboveBelowAverage aboveBelowAverage = format.AboveBelowAverage;
+ format.FormatType = ExcelCFType.AboveBelowAverage
+ Dim aboveBelowAverage As IAboveBelowAverage = format.AboveBelowAverage
'Set AverageType as Below for AboveBelowAverage rule.
- aboveBelowAverage.AverageType = ExcelCFAverageType.Below;
+ aboveBelowAverage.AverageType = ExcelCFAverageType.Below
- 'Set color for Conditional Formattting.
- format.FontColorRGB = System.Drawing.Color.FromArgb(255, 255, 255);
- format.BackColorRGB = System.Drawing.Color.FromArgb(166, 59, 38);
+ 'Set color for Conditional Formatting.
+ format.FontColorRGB = Color.FromArgb(255, 255, 255)
+ format.BackColorRGB = Color.FromArgb(166, 59, 38)
'Saves the Excel
workbook.SaveAs("AboveBelowAverage.xlsx")
@@ -437,15 +437,15 @@ End Using
A complete working example to format above and below average values in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Conditional%20Formatting/Above%20and%20Below%20Average/.NET/Above%20and%20Below%20Average).
-By executing the program, you will get the Excel file as below
+By executing the program, you will get the Excel file as shown below.
-### Above or Below Standard Deviation values
+### Above or Below Standard Deviation Values
-The following code example illustrates how to format a range with values above standard deviation, using [IAboveBelowAverage](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html) [AverageType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html#Syncfusion_XlsIO_IAboveBelowAverage_AverageType) and [StdDevValue](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html#Syncfusion_XlsIO_IAboveBelowAverage_StdDevValue) properties in XlsIO.
+The following code example illustrates how to format a range with values above the standard deviation, using the [IAboveBelowAverage](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html) [AverageType](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html#Syncfusion_XlsIO_IAboveBelowAverage_AverageType) and [StdDevValue](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IAboveBelowAverage.html#Syncfusion_XlsIO_IAboveBelowAverage_StdDevValue) properties in XlsIO.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Conditional%20Formatting/Above%20and%20Below%20Standard%20Deviation/.NET/Above%20and%20Below%20Standard%20Deviation/Above%20and%20Below%20Standard%20Deviation/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
@@ -484,7 +484,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
application.DefaultVersion = ExcelVersion.Excel2013;
- IWorkbook workbook = workbook = application.Workbooks.Open("CFTemplate.xlsx");
+ IWorkbook workbook = application.Workbooks.Open("CFTemplate.xlsx");
IWorksheet worksheet = workbook.Worksheets[0];
//Applying conditional formatting to "M6:M35"
@@ -506,7 +506,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
format.BackColorRGB = System.Drawing.Color.FromArgb(166, 59, 38);
//Saves the Excel
- workbook.SaveAs("AboveBelowAverage.xlsx");
+ workbook.SaveAs("AboveBelowAverage.xlsx");
}
{% endhighlight %}
@@ -518,12 +518,12 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
Dim worksheet As IWorksheet = workbook.Worksheets(0)
'Applying conditional formatting to "M6:M35"
- IConditionalFormats formats = worksheet.Range["M6:M35"].ConditionalFormats;
- IConditionalFormat format = formats.AddCondition();
+ Dim formats As IConditionalFormats = worksheet.Range("M6:M35").ConditionalFormats
+ Dim format As IConditionalFormat = formats.AddCondition()
'Applying above or below average rule in the conditional formatting
- format.FormatType = ExcelCFType.AboveBelowAverage;
- IAboveBelowAverage aboveBelowAverage = format.AboveBelowAverage;
+ format.FormatType = ExcelCFType.AboveBelowAverage
+ Dim aboveBelowAverage As IAboveBelowAverage = format.AboveBelowAverage
'Set AverageType as AboveStdDev for AboveBelowAverage rule.
aboveBelowAverage.AverageType = ExcelCFAverageType.AboveStdDev
@@ -531,9 +531,9 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
'Set value to StdDevValue property for AboveBelowAverage rule.
aboveBelowAverage.StdDevValue = 1
- 'Set color for Conditional Formattting.
- format.FontColorRGB = System.Drawing.Color.FromArgb(255, 255, 255);
- format.BackColorRGB = System.Drawing.Color.FromArgb(166, 59, 38);
+ 'Set color for Conditional Formatting.
+ format.FontColorRGB = Color.FromArgb(255, 255, 255)
+ format.BackColorRGB = Color.FromArgb(166, 59, 38)
'Saves the Excel
workbook.SaveAs("AboveBelowAverage.xlsx")
@@ -543,8 +543,8 @@ End Using
A complete working example to format above and below standard deviation values in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Conditional%20Formatting/Above%20and%20Below%20Standard%20Deviation/.NET/Above%20and%20Below%20Standard%20Deviation).
-By executing the program, you will get the Excel file as below
+By executing the program, you will get the Excel file as shown below.
-
+
-N> **IAboveBelowAverage** **StdDevValue** can be applied only if the **AverageType** is **AboveStdDev** or **BelowStdDev**. The **StdDevValue** value should be in a range between 1 and 3.
\ No newline at end of file
+N> The **IAboveBelowAverage** **StdDevValue** can be applied only if the **AverageType** is **AboveStdDev** or **BelowStdDev**. The **StdDevValue** value should be in a range between 1 and 3.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Custom-XML-Support.md b/Document-Processing/Excel/Excel-Library/NET/Custom-XML-Support.md
index 5aa4f71987..dd88e14541 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Custom-XML-Support.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Custom-XML-Support.md
@@ -7,18 +7,18 @@ documentation: UG
---
# Custom XML Support in Syncfusion® Excel Library
-When you embed XML data in a document, the data is named as custom XML part, which is used to store arbitrary XML data in the workbook.
+A custom XML part is arbitrary XML data embedded in the workbook.
-Essential® XlsIO supports the following functionalities with Custom XML:
+Essential® XlsIO supports the following Custom XML features:
* Adding CustomXmlPart to workbook
-* Reading CustomXmlPart from workbook
+* Reading CustomXmlPart from workbook
-**Add** **Custom** **XML**
+**Add Custom XML**
-Adding Custom XML part to workbook is achieved by using the [Add](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html#Syncfusion_XlsIO_ICustomXmlPartCollection_Add_Syncfusion_XlsIO_ICustomXmlPart_) method of [ICustomXmlPartCollection](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html) interface.
+A Custom XML part is added by using the [Add](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html#Syncfusion_XlsIO_ICustomXmlPartCollection_Add_Syncfusion_XlsIO_ICustomXmlPart_) method of the [ICustomXmlPartCollection](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html) interface.
-The following code snippet illustrates on how to add a Custom XML part.
+The following code snippet illustrates how to add a Custom XML part.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Custom%20XML%20Support/Add%20Custom%20XML/.NET/Add%20Custom%20XML/Add%20Custom%20XML/Program.cs,180" %}
@@ -40,8 +40,6 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Saving the workbook
workbook.SaveAs(Path.GetFullPath("Output/CreateCustomXML.xlsx"));
#endregion
-
- //Open default JSON
}
{% endhighlight %}
@@ -57,7 +55,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
ICustomXmlPart customXmlPart = workbook.CustomXmlparts.Add("SD10003");
//Add XmlData to CustomXmlPart
- byte[] xmlData = File.ReadAllBytes("Test.xml");
+ byte[] xmlData = File.ReadAllBytes(Path.GetFullPath("Test.xml"));
customXmlPart.Data = xmlData;
workbook.SaveAs("CustomXml.xlsx");
@@ -75,7 +73,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
Dim customXmlPart As ICustomXmlPart = workbook.CustomXmlparts.Add("SD10003")
'Add XmlData to CustomXmlPart
- Dim xmlData() As Byte = File.ReadAllBytes("Test.xml")
+ Dim xmlData() As Byte = File.ReadAllBytes(Path.GetFullPath("Test.xml"))
customXmlPart.Data = xmlData
workbook.SaveAs("CustomXml.xlsx")
@@ -83,11 +81,11 @@ End Using
{% endhighlight %}
{% endtabs %}
-A complete working example to add custom XML in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Custom%20XML%20Support/Add%20Custom%20XML/.NET/Add%20Custom%20XML).
+A complete working example to add custom XML in C# is available on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Custom%20XML%20Support/Add%20Custom%20XML/.NET/Add%20Custom%20XML).
-**Read** **Custom** **XML**
+**Read Custom XML**
-Reading Custom XML part from workbook is achieved by using the [GetById](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html#Syncfusion_XlsIO_ICustomXmlPartCollection_GetById_System_String_) method of [ICustomXmlPartCollection](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html) interface. The following code snippet illustrates on how to read Custom XML parts from workbook.
+A Custom XML part is read by using the [GetById](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html#Syncfusion_XlsIO_ICustomXmlPartCollection_GetById_System_String_) method of the [ICustomXmlPartCollection](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ICustomXmlPartCollection.html) interface. The following code snippet illustrates how to read Custom XML parts from the workbook.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Custom%20XML%20Support/Read%20Custom%20XML/.NET/Read%20Custom%20XML/Read%20Custom%20XML/Program.cs,180" %}
@@ -149,10 +147,12 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
workbook.SaveAs("CustomXml.xlsx")
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
+
+A complete working example to read custom XML in C# is available on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Custom%20XML%20Support/Read%20Custom%20XML/.NET/Read%20Custom%20XML).
-A complete working example to read custom XML in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Custom%20XML%20Support/Read%20Custom%20XML/.NET/Read%20Custom%20XML).
+**Supported File Formats**
-N> Custom XML cannot be modified when the file is saved in Excel 97-2003 (\*.xls) format.
-N> Custom XML can be created and modified when the file is saved in Excel 2007 and later versions (\*.xlsx).
+N> Custom XML is not supported in the Excel 97-2003 (\*.xls) format.
+N> Custom XML is supported in Excel 2007 and later versions (\*.xlsx, \*.xlsm, \*.xltx).
diff --git a/Document-Processing/Excel/Excel-Library/NET/Import-Export/Export-from-Excel.md b/Document-Processing/Excel/Excel-Library/NET/Import-Export/Export-from-Excel.md
index f88ea5741d..b45f170aef 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Import-Export/Export-from-Excel.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Import-Export/Export-from-Excel.md
@@ -1,6 +1,6 @@
---
-title: Export from Excel document | Syncfusion
-description: In this section, you can learn how to export data from Excel document using Syncfusion Essential XlsIO..
+title: Export from Excel Document | Syncfusion
+description: Learn to export data from Excel documents using Syncfusion Essential XlsIO, enabling efficient data extraction and seamless integration.
platform: document-processing
control: XlsIO
documentation: UG
@@ -10,11 +10,11 @@ documentation: UG
## Excel to DataTable
-XlsIO allows to export the sheet data to a **DataTable** by using the [ExportDataTable()](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.html#Syncfusion_XlsIO_Implementation_WorksheetImpl_ExportDataTable_Syncfusion_XlsIO_IRange_Syncfusion_XlsIO_ExcelExportDataTableOptions_) method. This method provides various options that allows to export data with specific requirement through ExcelExportDataTableOptions.
+XlsIO allows you to export the sheet data to a **DataTable** by using the [ExportDataTable()](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.html#Syncfusion_XlsIO_Implementation_WorksheetImpl_ExportDataTable_Syncfusion_XlsIO_IRange_Syncfusion_XlsIO_ExcelExportDataTableOptions_) method. This method provides various options that allow you to export data with specific requirements through `ExcelExportDataTableOptions`.
N> XlsIO supports exporting of data from worksheet to data table in Windows Forms, WPF, ASP.NET, ASP.NET MVC and ASP.NET Core (2.0 onwards) platforms alone.
-The following code example illustrates on how to export data from Excel to Data grid using **DataTable**.
+The following code example illustrates how to export data from an Excel sheet to a data grid using a **DataTable**.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/Worksheet%20to%20DataTable/.NET/Worksheet%20to%20DataTable/Worksheet%20to%20DataTable/Program.cs,180" %}
@@ -26,7 +26,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
IWorksheet worksheet = workbook.Worksheets[0];
//Read all data from the used range of worksheet and Export to the DataTable
- DataTable customersTable = worksheet.ExportDataTable(worksheet.UsedRange, ExcelExportDataTableOptions.ColumnNames | ExcelExportDataTableOptions.ComputedFormulaValues);
+ DataTable customersTable = worksheet.ExportDataTable(worksheet.UsedRange, ExcelExportDataTableOptions.ColumnNames | ExcelExportDataTableOptions.ComputedFormulaValues);
IRange range = worksheet.Range["A1:B10"];
@@ -34,7 +34,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
DataTable customersTable1 = worksheet.ExportDataTable(range, ExcelExportDataTableOptions.ColumnNames | ExcelExportDataTableOptions.ComputedFormulaValues);
}
-//XlsIO supports binding of exported data table to data grid in Windows Forms, WPF, ASP.NET and ASP.NET MVC platforms alone.
+//XlsIO supports binding of exported data table to a data grid in Windows Forms, WPF, ASP.NET, and ASP.NET MVC platforms alone.
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
@@ -48,8 +48,8 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Read data from the worksheet and Export to the DataTable
DataTable customersTable = worksheet.ExportDataTable(worksheet.UsedRange, ExcelExportDataTableOptions.ColumnNames | ExcelExportDataTableOptions.ComputedFormulaValues);
- //Binding exported DataTable to data grid, likewise it can binded to any
- //user interface control which supports binding
+ //Bind the exported DataTable to a data grid. Similarly, it can be bound to any
+ //user interface control that supports binding.
DataGrid dataGrid = new DataGrid();
dataGrid.DataSource = customersTable;
@@ -67,8 +67,8 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
'Read data from the worksheet and Export to the DataTable
Dim customersTable As DataTable = sheet.ExportDataTable(sheet.UsedRange, ExcelExportDataTableOptions.ColumnNames Or ExcelExportDataTableOptions.ComputedFormulaValues)
- 'Binding exported DataTable to data grid, likewise it can binded to any
- 'user interface control which supports binding
+ 'Bind the exported DataTable to a data grid. Similarly, it can be bound to any
+ 'user interface control that supports binding.
Dim dataGrid As DataGrid = New DataGrid
dataGrid.DataSource = customersTable
@@ -79,17 +79,17 @@ End Using
A complete working example to export data from Excel to DataTable in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Import%20and%20Export%20Data/Worksheet%20to%20DataTable/.NET/Worksheet%20to%20DataTable).
-### Excel to Data Table with an Event
+### Excel to DataTable with an Event
-Sometimes there may be a need to control the data export from Excel to a data table. XlsIO provides an event [ExportDataTableEvent](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.ExportDataTableEventHandler.html) to trigger while exporting data from an Excel worksheet to a data table. This event helps to perform the following actions through the [ExportDataTableActions](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.ExportDataTableEventArgs.html#Syncfusion_XlsIO_Implementation_ExportDataTableEventArgs_ExportDataTableAction) enumeration.
+Sometimes you may need to control the data export from Excel to a data table. XlsIO provides an event [ExportDataTableEvent](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.ExportDataTableEventHandler.html) that is triggered while exporting data from an Excel worksheet to a data table. This event helps perform the following actions through the [ExportDataTableActions](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.ExportDataTableEventArgs.html#Syncfusion_XlsIO_Implementation_ExportDataTableEventArgs_ExportDataTableAction) enumeration.
-* Default - Exports worksheet data to the data table without any action.
-* SkipRows - Exports worksheet data to the data table by skipping a specific row(s).
-* StopExporting - Stops exporting the data from Excel worksheet to the data table.
+* **Default** – Exports worksheet data to the data table without any action.
+* **SkipRow** – Exports worksheet data to the data table by skipping a specific row.
+* **StopExporting** – Stops exporting the data from the Excel worksheet to the data table.
N> XlsIO supports exporting of data from worksheet to data table in Windows Forms, WPF, ASP.NET, ASP.NET MVC and ASP.NET Core (NETStandard2.0 onwards) platforms alone.
-The following code example illustrates how to export data from an Excel to a data table by triggering an event.
+The following code example illustrates how to export data from an Excel worksheet to a data table by triggering an event.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -110,7 +110,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
workbook.SaveAs("ExportToDT.xlsx");
}
-//XlsIO supports binding of exported data table to data grid in Windows Forms, WPF, ASP.NET and ASP.NET MVC platforms alone
+//XlsIO supports binding of exported data table to a data grid in Windows Forms, WPF, ASP.NET, and ASP.NET MVC platforms alone.
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
@@ -118,16 +118,16 @@ using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
application.DefaultVersion = ExcelVersion.Excel2016;
- IWorkbook workbook = application.Workbooks.Open("sample.xlsx");
+ IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
IWorksheet worksheet = workbook.Worksheets[0];
//Event to choose an action while exporting data from Excel to data table.
- worksheet.ExportDataTableEvent += ExportDataTable_EventAction();
+ worksheet.ExportDataTableEvent += ExportDataTable_EventAction;
//Read data from the worksheet and Export to the DataTable
DataTable customersTable = worksheet.ExportDataTable(worksheet.UsedRange, ExcelExportDataTableOptions.ColumnNames);
- //Binding the exported data table to a data grid. It can be bound to any control that supports the data table.
+ //Bind the exported data table to a data grid. It can be bound to any control that supports the data table.
DataGrid dataGrid = new DataGrid();
dataGrid.DataSource = customersTable;
workbook.SaveAs("ExportToGrid.xlsx");
@@ -147,7 +147,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
'Read data from the worksheet and Export to the DataTable
Dim customersTable As DataTable = sheet.ExportDataTable(sheet.UsedRange, ExcelExportDataTableOptions.ColumnNames)
- 'Binding the exported data table to a data grid. It can be bound to any control that supports the data table.
+ 'Bind the exported data table to a data grid. It can be bound to any control that supports the data table.
Dim dataGrid As DataGrid = New DataGrid
dataGrid.DataSource = customersTable
workbook.SaveAs("ExportToGrid.xlsx")
@@ -164,7 +164,7 @@ private void ExportDataTable_EventAction(ExportDataTableEventArgs e)
if (e.ExcelValue != null && e.ExcelValue.ToString() == "Owner")
e.ExportDataTableAction = ExportDataTableActions.SkipRow;
- if (e.DataTableColumnIndex ==0 && e.ExcelRowIndex == 5 && e.ExcelColumnIndex == 1)
+ if (e.DataTableColumnIndex == 0 && e.ExcelRowIndex == 5 && e.ExcelColumnIndex == 1)
e.ExportDataTableAction = ExportDataTableActions.StopExporting;
if (e.ExcelValue != null && e.ExcelValue.ToString() == "Mexico D.F.")
@@ -180,8 +180,8 @@ private void ExportDataTable_EventAction(ExportDataTableEventArgs e)
{
if (e.ExcelValue != null && e.ExcelValue.ToString() == "Owner")
e.ExportDataTableAction = ExportDataTableActions.SkipRow;
-
- if (e.DataTableColumnIndex ==0 && e.ExcelRowIndex == 5 && e.ExcelColumnIndex == 1)
+
+ if (e.DataTableColumnIndex == 0 && e.ExcelRowIndex == 5 && e.ExcelColumnIndex == 1)
e.ExportDataTableAction = ExportDataTableActions.StopExporting;
if (e.ExcelValue != null && e.ExcelValue.ToString() == "Mexico D.F.")
@@ -194,7 +194,7 @@ private void ExportDataTable_EventAction(ExportDataTableEventArgs e)
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
Private Sub ExportDataTable_EventAction(ByVal e As ExportDataTableEventArgs)
- If e.ExcelValue IsNot Nothing AndAlso e.ExcelValue.ToString() = "Owner" Then
+ If e.ExcelValue IsNot Nothing AndAlso e.ExcelValue.ToString() = "Owner" Then
e.ExportDataTableAction = ExportDataTableActions.SkipRow
If e.DataTableColumnIndex = 0 AndAlso e.ExcelRowIndex = 5 AndAlso e.ExcelColumnIndex = 1 Then
@@ -209,11 +209,11 @@ End Sub
{% endhighlight %}
{% endtabs %}
-## Excel to Collection Objects
+## Excel to Collection Objects
-XlsIO allows to export the sheet data to a **Collection Objects** by using the [ExportData<T>()](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.html#Syncfusion_XlsIO_Implementation_WorksheetImpl_ExportData__1_System_Int32_System_Int32_System_Int32_System_Int32_) method.
+XlsIO allows you to export the sheet data to **collection objects** by using the [ExportData<T>()](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.html#Syncfusion_XlsIO_Implementation_WorksheetImpl_ExportData__1_System_Int32_System_Int32_System_Int32_System_Int32_) method. The parameters represent the starting row, starting column, ending row, and ending column of the range to export.
-The following code example illustrates on how to export Excel data into Collection Objects using **ExportData<T>**.
+The following code example illustrates how to export Excel data into collection objects using **ExportData<T>**.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/Worksheet%20to%20CollectionObjects/.NET/Worksheet%20to%20CollectionObjects/Worksheet%20to%20CollectionObjects/Program.cs,180" %}
@@ -259,10 +259,10 @@ End Using
{% endhighlight %}
{% endtabs %}
-The following code snippet provides supporting class for the above code. Here, the attributes **DisplayNameAttribute** and **Bindable** are used.
+The following code snippet provides the supporting class for the above code. Here, the attributes **DisplayNameAttribute** and **Bindable** are used.
-* [DisplayNameAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.componentmodel.displaynameattribute?view=netframework-4.7.1) - to match the column headers with set of properties while exporting.
-* [BindableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.componentmodel.bindableattribute?view=netframework-4.8) - to skip a property while exporting.
+* [DisplayNameAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.componentmodel.displaynameattribute?view=netframework-4.7.1) – matches the column headers in the worksheet with the corresponding class properties while exporting.
+* [BindableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.componentmodel.bindableattribute?view=netframework-4.8) – when set to `false`, excludes the property from the export.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -300,36 +300,36 @@ public class Report
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
Public Class Report
Private m_SalesPerson As String
- Private m_SalesJanJun As String
+ Private m_SalesJanJun As String
Private m_SalesJulDec As String
Public Property SalesPerson() As String
- Get
- Return m_SalesPerson
- End Get
- Set(value As String)
- m_SalesPerson = Value
- End Set
+ Get
+ Return m_SalesPerson
+ End Get
+ Set(value As String)
+ m_SalesPerson = Value
+ End Set
End Property
Public Property SalesJanJun() As String
- Get
- Return m_SalesJanJun
- End Get
- Set(value As String)
- m_SalesJanJun = Value
- End Set
+ Get
+ Return m_SalesJanJun
+ End Get
+ Set(value As String)
+ m_SalesJanJun = Value
+ End Set
End Property
Public Property SalesJulDec() As String
- Get
- Return m_SalesJulDec
- End Get
- Set(value As String)
- m_SalesJulDec = Value
- End Set
+ Get
+ Return m_SalesJulDec
+ End Get
+ Set(value As String)
+ m_SalesJulDec = Value
+ End Set
End Property
End Class
{% endhighlight %}
@@ -339,13 +339,13 @@ A complete working example to export data from Excel to collection objects in C#
### Excel to Nested Class Objects
-XlsIO allows to export worksheet data to nested class objects. A new overload to the existing [ExportData()](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.html#Syncfusion_XlsIO_Implementation_WorksheetImpl_ExportData__1_System_Int32_System_Int32_System_Int32_System_Int32_System_Collections_Generic_Dictionary_System_String_System_String__) method helps to achieve this requirement by mapping column headers with class properties.
+XlsIO allows you to export worksheet data to nested class objects. An overload of the [ExportData()](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Implementation.WorksheetImpl.html#Syncfusion_XlsIO_Implementation_WorksheetImpl_ExportData__1_System_Int32_System_Int32_System_Int32_System_Int32_System_Collections_Generic_Dictionary_System_String_System_String__) method enables this by mapping column headers with class properties (including nested properties using dot notation, for example, `CustOrder.Order_Id`).
-Let’s consider the input Excel document has the data as shown in the below screenshot.
+Consider the following input Excel document, as shown in the screenshot below.
-The following code example illustrates how to export data from Excel to nested class objects with column headers mapping collection.
+The following code example illustrates how to export data from Excel to nested class objects using a column header mapping collection.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/Worksheet%20to%20Nested%20Class/.NET/Worksheet%20to%20Nested%20Class/Worksheet%20to%20Nested%20Class/Program.cs,180" %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Import-Export/Import-to-Excel.md b/Document-Processing/Excel/Excel-Library/NET/Import-Export/Import-to-Excel.md
index 55a9bedf2f..4a8a2b976e 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Import-Export/Import-to-Excel.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Import-Export/Import-to-Excel.md
@@ -1,18 +1,18 @@
---
-title: Import to Excel document | Syncfusion
-description: In this section, you can learn how to import data to Excel document using Syncfusion Essential XlsIO..
+title: Import to Excel Worksheet | .NET XlsIO | Syncfusion
+description: Learn to import data into Excel worksheets from DataTables, collections, arrays, grids, HTML tables, and XML files using XlsIO.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Import to Excel Document
+# Import to Excel Worksheet
## DataTable to Excel
-The following code example illustrates on how to import a DataTable into an Excel using [ImportDataTable](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataTable_System_Data_DataTable_Syncfusion_XlsIO_IName_System_Boolean_System_Int32_System_Int32_) method.
+The following code example illustrates how to import a `DataTable` into Excel using the [ImportDataTable](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataTable_System_Data_DataTable_Syncfusion_XlsIO_IName_System_Boolean_System_Int32_System_Int32_) method. The parameters of the `ImportDataTable(dataTable, hasHeader, row, column, preserveTypes)` overload are: `dataTable` – the source `DataTable`; `hasHeader` – `true` to import the column names as the first row; `row` and `column` – the one-based starting cell; and `preserveTypes` – `true` to apply the `DataColumn` data type to the cell (default `false`).
-N> XlsIO supports importing of data from data table to worksheet in Windows Forms, WPF, ASP.NET, ASP.NET MVC and ASP.NET Core (2.0 onwards) platforms alone.
+N> XlsIO supports importing data from a `DataTable` to a worksheet in Windows Forms, WPF, ASP.NET, ASP.NET MVC, and ASP.NET Core (2.0 onwards) only.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/DataTable%20to%20Worksheet/.NET/DataTable%20to%20Worksheet/DataTable%20to%20Worksheet/Program.cs,180" %}
@@ -73,7 +73,7 @@ End Using
A complete working example to import data from DataTable to Excel in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Import%20and%20Export%20Data/DataTable%20to%20Worksheet/.NET/DataTable%20to%20Worksheet).
-N> XlsIO imports the data from data table into Excel worksheet based on the data table column type. So, it is suggested to create the data tables with required column types such as number, text or date time before importing the data table to Excel worksheet.
+N> XlsIO imports the data from a `DataTable` into an Excel worksheet based on the column type of the data table. It is recommended to create the `DataTable` columns with the required types (number, text, or `DateTime`) before importing it into Excel.
### Preserve Data Types
@@ -95,9 +95,9 @@ worksheet.ImportDataTable(table, False, 1, 1, True) ' preserveTypes = True
## DataColumn to Excel
-The following code example illustrates how to import DataColumn into an Excel using [ImportDataColumn](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataColumn_System_Data_DataColumn_System_Boolean_System_Int32_System_Int32_) method.
+The following code example illustrates how to import a `DataColumn` into Excel using the [ImportDataColumn](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataColumn_System_Data_DataColumn_System_Boolean_System_Int32_System_Int32_) method. The `ImportDataColumn(dataColumn, addHeader, row, column)` parameters are: `dataColumn` – the source column; `addHeader` – `true` to include the column name as a header; `row` and `column` – the one-based starting cell.
-N> XlsIO supports importing data column to worksheet in Windows Forms, WPF, ASP.NET, ASP.NET MVC and ASP.NET Core (2.0 onwards) platforms alone.
+N> XlsIO supports importing a `DataColumn` to a worksheet in Windows Forms, WPF, ASP.NET, ASP.NET MVC, and ASP.NET Core (2.0 onwards) only.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/DataColumn%20to%20Worksheet/.NET/DataColumn%20to%20Worksheet/DataColumn%20to%20Worksheet/Program.cs,180" %}
@@ -163,9 +163,9 @@ A complete working example to import data from DataColumn to Excel in C# is pres
## DataView to Excel
-The following code example illustrates how to import DataView into an Excel using [ImportDataView](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataView_System_Data_DataView_System_Boolean_System_Int32_System_Int32_) method.
+The following code example illustrates how to import a `DataView` into Excel using the [ImportDataView](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataView_System_Data_DataView_System_Boolean_System_Int32_System_Int32_) method. The `ImportDataView(dataView, hasHeader, row, column)` parameters are: `dataView` – the source `DataView`; `hasHeader` – `true` to include column names; `row` and `column` – the one-based starting cell.
-N> XlsIO supports importing data view to worksheet in Windows Forms, WPF, ASP.NET, ASP.NET MVC and ASP.NET Core (2.0 onwards) platforms alone.
+N> XlsIO supports importing a `DataView` to a worksheet in Windows Forms, WPF, ASP.NET, ASP.NET MVC, and ASP.NET Core (2.0 onwards) only.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/DataView%20to%20Worksheet/.NET/DataView%20to%20Worksheet/DataView%20to%20Worksheet/Program.cs,180" %}
@@ -339,7 +339,7 @@ public static List GetSalesReports()
public class Customer
{
[DisplayNameAttribute("Sales Person Name")]
- public string SalesPerson { get; set;
+ public string SalesPerson { get; set; }
[Bindable(false)]
public string SalesJanJun { get; set; }
public string SalesJulDec { get; set; }
@@ -413,14 +413,19 @@ A complete working example to import data from Collection Objects to Excel in C#
**Data Options**
-[ExcelImportDataOptions](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelImportDataOptions.html) is a support class for [ImportData](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportData_System_Collections_IEnumerable_Syncfusion_XlsIO_ExcelImportDataOptions_) method which contains various properties to import data with formatting.
+[ExcelImportDataOptions](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.ExcelImportDataOptions.html) is a supporting class for the [ImportData](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportData_System_Collections_IEnumerable_Syncfusion_XlsIO_ExcelImportDataOptions_) method and contains various properties to import data with formatting.
-**ExcelImportDataOptions** class contains the following properties:
+**ExcelImportDataOptions** exposes the following properties:
-FirstRow - Specifies first row from where the data should be imported.
-FirstColumn - Specifies first column from where the data should be imported.
-IncludeHeader - Specifies whether class properties names must be imported or not.
-PreserveTypes - Indicates whether XlsIO should preserve column types from Data. By default, preserve type is TRUE. Setting it to True will import data based on column type, otherwise will import based on value type.
+| Property | Description |
+| --- | --- |
+| `FirstRow` | Specifies the first row from where the data should be imported. |
+| `FirstColumn` | Specifies the first column from where the data should be imported. |
+| `IncludeHeader` | Specifies whether the class property names must be imported as column headers. |
+| `PreserveTypes` | Indicates whether XlsIO should preserve the column types from the source data. By default, `PreserveTypes` is `true`; setting it to `true` imports data based on the column type, otherwise it imports based on the value type. |
+| `NestedDataLayoutOptions` | Controls the layout of imported hierarchical data (`Default`, `Merge`, or `Repeat`). |
+| `NestedDataGroupOptions` | Groups hierarchical data on import (`Expand` or `Collapse`). |
+| `CollapseLevel` | Specifies the collapse level (1–8) when `NestedDataGroupOptions` is `Collapse`. |
The following code example illustrates how to import collection objects into an Excel using **ImportData** method with **ExcelImportDataOptions** class.
@@ -490,7 +495,7 @@ Using excelEngine As ExcelEngine = New ExcelEngine()
importDataOptions.IncludeHeader = False
importDataOptions.PreserveTypes = False
- worksheet.ImportData(output, importDataOptions)
+ worksheet.ImportData(reports, importDataOptions)
workbook.SaveAs("ImportData.xlsx")
End Using
@@ -545,7 +550,7 @@ public static List GetSalesReports()
//Customer details
public class Customer
{
- public string SalesPerson { get; set;
+ public string SalesPerson { get; set; }
public string SalesJanJun { get; set; }
public string SalesJulDec { get; set; }
@@ -616,9 +621,9 @@ A complete working example to import data to Excel with import data options in C
### Nested Collection Objects to Excel
-Import hierarchical data from nested collections to Excel helps the user to analyze data in its structure. XlsIO provides more flexible options to analyze such data by importing in different layouts and grouping the imported data.
+Importing hierarchical data from nested collections into Excel lets you analyze the data while preserving its structure. XlsIO provides flexible options to import such data in different layouts and to group the imported data.
-Data import can be done with the layout options:
+You can import the data with the following layout options:
* **Default** - Parent records imported in the first row of its collection.
* **Merge** - Parent records imported in merged rows.
@@ -635,7 +640,7 @@ Let’s see these options in detail along with code examples and screenshots.
**Default layout option**
-This option adds the property value once per object for the corresponding records in the column while importing.
+This option adds the parent property value only once, on the first row of each group, while importing.
The following code example illustrates how to import data directly from nested collection objects with default layout option. The input XML file used in the code can be downloaded [here](https://www.syncfusion.com/downloads/support/directtrac/general/ze/ExportData831552872.zip).
@@ -1296,9 +1301,9 @@ The following screenshot represents the output document with Repeat layout optio
**Grouping Options**
-Hierarchical data imported into Excel worksheet must be shown its structure to analyze more flexible. In addition, if the data is grouped according to its level, it is easier to analyze. XlsIO supports to import hierarchical data from nested collection and group them while importing.
+Hierarchical data imported into an Excel worksheet is best visualized with its structure preserved; if the data is grouped according to its level, analysis becomes much easier. XlsIO supports importing hierarchical data from a nested collection and grouping the imported data.
-The following are the options that is supported to group on import.
+The following grouping options are supported on import:
* **Expand** – Imported data will be grouped and expanded.
* **Collapse** – Imported data will be grouped and collapsed at first level, by default.
@@ -1768,7 +1773,7 @@ Namespace ImportFromNestedCollection
'Set collapse level.
'GroupingOption must set to ‘Collapse’ before applying ‘CollapseLevel’.
- importDataOptions.CollapseLevel = 2;
+ importDataOptions.CollapseLevel = 2
'Import data from the nested collection.
worksheet.ImportData(vehicles, importDataOptions)
@@ -1938,7 +1943,7 @@ The following screenshot represents the output document of Grouped data imported
**Collection Objects with hyperlink**
-XlsIO allows you to import images, data with URLs, and data with mail IDs as hyperlinks from various data sources binded in Collection Objects as shown below
+XlsIO allows you to import images, data with URLs, and data with mail IDs as hyperlinks from various data sources bound to collection objects, as shown below
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink=" https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Import%20and%20Export%20Data/Import%20with%20Hyperlink/.NET/Import%20with%20Hyperlink/Import%20with%20Hyperlink/Program.cs,180" %}
@@ -2233,7 +2238,7 @@ A complete working example to import data from array to an Excel in C# is presen
## Microsoft Grid Controls to Excel
-XlsIO provides support to import data from various Microsoft grid controls with its cell formatting. The supported grid controls are:
+XlsIO can import data from various Microsoft grid controls while preserving their cell formatting. The supported grid controls are:
* DataGrid
* GridView
@@ -2241,7 +2246,7 @@ XlsIO provides support to import data from various Microsoft grid controls with
### DataGrid
-Imports data from Microsoft DataGrid control with its header and cell formatting to Excel worksheet. The following code example illustrates how to import data from Microsoft DataGrid control to Excel.
+Imports data from a Microsoft DataGrid control, preserving its header and cell formatting, into an Excel worksheet. The following code example illustrates how to import data from a Microsoft DataGrid control to Excel.
N> GetDataTable() method returns DataTable of applicable data to import.
@@ -2341,7 +2346,7 @@ excelEngine.Dispose()
### DataGridView
-Imports data from Microsoft DataGridView control with its header and cell formatting to Excel worksheet. In addition, this API imports sorted data applied in the control. The following code example illustrates how to import data from Microsoft DataGridView control to Excel.
+Imports data from a Microsoft DataGridView control, preserving its header and cell formatting, into an Excel worksheet. In addition, this API imports the sort order applied to the control. The following code example illustrates how to import data from a Microsoft DataGridView control to Excel.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -2487,9 +2492,9 @@ The following screenshot represents the image of the Excel output with data impo
-N> Syncfusion® XlsIO supports importing HTML tables with the inline styles alone. HTML documents with embedded styles or style sheets are not supported.
+N> Syncfusion® XlsIO supports importing HTML tables with inline styles only. HTML documents with embedded styles or external style sheets are not supported.
-N> Syncfusion® XlsIO depends on the XMLDocument object to load HTML string in which the "<" and "&" symbols are invalid. These symbols needs to be changed as "<" and "&" respectively, to overcome the xml exception.
+N> Syncfusion® XlsIO depends on the `XmlDocument` object to load the HTML string; in XML, the `<` and `&` symbols are invalid. These symbols need to be encoded as `<` and `&` respectively to avoid an XML exception. For example, `<` becomes `<` and `&` becomes `&` in the input HTML.
N> Data formatting can be applied to the Excel cells only after importing the HTML table to Excel.
diff --git a/Document-Processing/Excel/Excel-Library/NET/Improving-Performance.md b/Document-Processing/Excel/Excel-Library/NET/Improving-Performance.md
index ad00a1ab3a..08629c5ac9 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Improving-Performance.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Improving-Performance.md
@@ -1,17 +1,39 @@
---
title: Improving Performance | Syncfusion
-description: This section explains how to improve performance in the .NET Excel Library with clear guidance and practical examples.
+description: Discover Syncfusion XlsIO performance best practices with code examples for reading, writing, styling, autofit, data import, and validation.
platform: document-processing
control: XlsIO
documentation: UG
---
# Improving Performance
-This section gives you an idea for improving performance while developing with XlsIO.
+This section describes patterns that improve XlsIO performance when you read, write, format, or validate large workbooks. Measure a baseline first, then apply the patterns that target your bottleneck.
+
+## Prerequisites
+
+To use the examples in this section, ensure the following are in place:
+
+- Reference the **Syncfusion.XlsIO** assembly (or install the **Syncfusion.ExcelIO.Net.Core** NuGet package).
+- Include the required namespaces in your code file:
+
+ ```csharp
+ using Syncfusion.XlsIO;
+ using System.Drawing;
+ ```
+
+- Register the Syncfusion license in your application.
+- Always measure a baseline before applying a pattern, and again after, to confirm the improvement is meaningful for your data.
+
+## See also
+
+- [Working with cell or range formatting](https://help.syncfusion.com/document-processing/excel/excel-library/net/working-with-cell-or-range-formatting)
+- [Working with data validation](https://help.syncfusion.com/document-processing/excel/excel-library/net/working-with-data-validation)
+- [Working with data](https://help.syncfusion.com/document-processing/excel/excel-library/net/working-with-data)
+- [Syncfusion XlsIO overview](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview)
## UsedRange
-Get [UsedRange](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_UsedRange) globally. It is recommended to get the **UsedRange** in loops as follows
+Cache the [UsedRange](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_UsedRange) outside any loop that reads row or column bounds. `UsedRange` is a computed property; calling it on every iteration of a hot loop adds avoidable overhead.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -200,71 +222,69 @@ Next
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-ExcelEngine excelEngine = new ExcelEngine();
-excelEngine.Excel.DefaultVersion = ExcelVersion.Excel2013;
-IWorkbook workbook = excelEngine.Excel.Workbooks.Create();
-IWorksheet sheet = workbook.Worksheets[0];
-IMigrantRange migrantRange = workbook.Worksheets[0].MigrantRange;
-
-// Writing values.
-migrantRange.ResetRowColumn(1, 1);
-
-//Setting boolean value
-migrantRange.SetValue(true);
-migrantRange.ResetRowColumn(1, 2);
-
-//Setting DateTime value
-migrantRange.SetValue(DateTime.Now);
-migrantRange.ResetRowColumn(1, 3);
-
-//Setting double value
-migrantRange.SetValue(5.5);
-migrantRange.ResetRowColumn(1, 4);
-
-//Setting int value
-migrantRange.SetValue(5);
-migrantRange.ResetRowColumn(1, 5);
-
-//Setting string value
-migrantRange.SetValue("Syncfusion");
-workbook.Version = ExcelVersion.Excel2013;
-workbook.SaveAs("MigrantRange.xlsx");
-workbook.Close();
-excelEngine.Dispose();
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ excelEngine.Excel.DefaultVersion = ExcelVersion.Xlsx;
+ IWorkbook workbook = excelEngine.Excel.Workbooks.Create();
+ IMigrantRange migrantRange = workbook.Worksheets[0].MigrantRange;
+
+ // Writing values.
+ migrantRange.ResetRowColumn(1, 1);
+
+ //Setting boolean value
+ migrantRange.SetValue(true);
+ migrantRange.ResetRowColumn(1, 2);
+
+ //Setting DateTime value
+ migrantRange.SetValue(DateTime.Now);
+ migrantRange.ResetRowColumn(1, 3);
+
+ //Setting double value
+ migrantRange.SetValue(5.5);
+ migrantRange.ResetRowColumn(1, 4);
+
+ //Setting int value
+ migrantRange.SetValue(5);
+ migrantRange.ResetRowColumn(1, 5);
+
+ //Setting string value
+ migrantRange.SetValue("Syncfusion");
+
+ workbook.SaveAs("MigrantRange.xlsx");
+}
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-ExcelEngine excelEngine = new ExcelEngine();
-excelEngine.Excel.DefaultVersion = ExcelVersion.Excel2013;
-IWorkbook workbook = excelEngine.Excel.Workbooks.Create();
-IWorksheet sheet = workbook.Worksheets[0];
-IMigrantRange migrantRange = workbook.Worksheets[0].MigrantRange;
-
-// Writing values.
-migrantRange.ResetRowColumn(1, 1);
-
-//Setting boolean value
-migrantRange.SetValue(true);
-migrantRange.ResetRowColumn(1, 2);
-
-//Setting DateTime value
-migrantRange.SetValue(DateTime.Now);
-migrantRange.ResetRowColumn(1, 3);
-
-//Setting double value
-migrantRange.SetValue(5.5);
-migrantRange.ResetRowColumn(1, 4);
-
-//Setting int value
-migrantRange.SetValue(5);
-migrantRange.ResetRowColumn(1, 5);
-
-//Setting string value
-migrantRange.SetValue("Syncfusion");
-workbook.Version = ExcelVersion.Excel2013;
-workbook.SaveAs("MigrantRange.xlsx");
-workbook.Close();
-excelEngine.Dispose();
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ excelEngine.Excel.DefaultVersion = ExcelVersion.Xlsx;
+ IWorkbook workbook = excelEngine.Excel.Workbooks.Create();
+ IMigrantRange migrantRange = workbook.Worksheets[0].MigrantRange;
+
+ // Writing values.
+ migrantRange.ResetRowColumn(1, 1);
+
+ //Setting boolean value
+ migrantRange.SetValue(true);
+ migrantRange.ResetRowColumn(1, 2);
+
+ //Setting DateTime value
+ migrantRange.SetValue(DateTime.Now);
+ migrantRange.ResetRowColumn(1, 3);
+
+ //Setting double value
+ migrantRange.SetValue(5.5);
+ migrantRange.ResetRowColumn(1, 4);
+
+ //Setting int value
+ migrantRange.SetValue(5);
+ migrantRange.ResetRowColumn(1, 5);
+
+ //Setting string value
+ migrantRange.SetValue("Syncfusion");
+
+ workbook.SaveAs("MigrantRange.xlsx");
+}
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
@@ -338,6 +358,7 @@ bodyStyle.Borders(ExcelBordersIndex.EdgeLeft).LineStyle = ExcelLineStyle.Thin
bodyStyle.Borders(ExcelBordersIndex.EdgeRight).LineStyle = ExcelLineStyle.Thin
bodyStyle.EndUpdate()
{% endhighlight %}
+
{% endtabs %}
### Set default row style and default column style
@@ -467,7 +488,7 @@ application.SkipAutoFitRow = True
## Importing DataTable
-[ImportDataTable](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataTable_System_Data_DataTable_System_Int32_System_Int32_System_Boolean_) overload method which has **ImportOnSave** argument allows you to import data with less memory consumption along with improved method performance by serializing the data directly on save method. This option is preferred for larger data that need to be imported in short time.
+The [ImportDataTable](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_ImportDataTable_System_Data_DataTable_System_Int32_System_Int32_System_Boolean_) overload that takes an `ImportOnSave` boolean argument lets you import a `DataTable` with lower memory usage by serializing the data directly during the `SaveAs` call. Prefer this overload when you are importing large data sets and do not need to modify the imported data afterward.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
diff --git a/Document-Processing/Excel/Excel-Library/NET/Known-Exceptions.md b/Document-Processing/Excel/Excel-Library/NET/Known-Exceptions.md
index 468c64edc0..3588db03bc 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Known-Exceptions.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Known-Exceptions.md
@@ -1,13 +1,27 @@
---
-title: Known exceptions thrown in XlsIO | Syncfusion
-description: Learn here all about the Known exceptions thrown in the Syncfusion's Excel (XlsIO) Library and more.
+title: Known Exceptions in Syncfusion XlsIO | Syncfusion
+description: Lists the known exceptions thrown by Syncfusion XlsIO, with the .NET exception type, XlsIO class, message, and the underlying reason.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Known Exceptions Details in Excel Library
+# Known Exceptions in Syncfusion XlsIO
-The list of known exceptions thrown in Essential® XlsIO is listed below.
+The following tables list the known exceptions that Essential® XlsIO can throw during read, write, formatting, and validation operations. Use these tables to identify the cause of an exception and to choose the correct `try`/`catch` block to handle it in your code.
+
+## How to read these tables
+
+Each row has three columns:
+
+- **Class** — the XlsIO type (such as `IWorkbook`, `IWorksheet`, or `IShape`) that the exception originates from.
+- **Message** — the text of the exception message as thrown by XlsIO.
+- **Reason** — a short user-facing explanation of why the exception is thrown and what range or value is expected.
+
+## See also
+
+- [Syncfusion XlsIO overview](https://help.syncfusion.com/document-processing/excel/excel-library/net/overview)
+- [System requirements](https://help.syncfusion.com/document-processing/system-requirements)
+- [Licensing requirements](https://help.syncfusion.com/document-processing/licensing/overview)
## ApplicationException
diff --git a/Document-Processing/Excel/Excel-Library/NET/Linux.md b/Document-Processing/Excel/Excel-Library/NET/Linux.md
index 02affcac8c..55726b1922 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Linux.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Linux.md
@@ -1,14 +1,22 @@
---
-title: FAQ about using XlsIO in Linux | Syncfusion
-description: This page explains about the frequently asked questions about using the .NET Excel (XlsIO) library in Linux environment.
+title: FAQ about using XlsIO on Linux | Syncfusion
+description: Find answers to common Syncfusion XlsIO Linux issues, including Docker setup, font installation, locale configuration, and SkiaSharp dependencies.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Frequently asked questions about using XlsIO in Linux
+# Frequently asked questions about using XlsIO on Linux
-The frequently asked questions about using XlsIO in Linux environment are listed below.
+This page covers common questions and fixes for using Syncfusion XlsIO in Linux environments, including Docker containers, font installation, locale setup, and SkiaSharp native dependencies. The font-related sections are only relevant for Excel-to-PDF or Excel-to-image conversion; reading and writing XLSX does not require fonts.
+
+## Prerequisites
+
+To follow the steps on this page, ensure the following are in place:
+
+- A Linux host or container based on Debian or Ubuntu (the `apt-get` snippets target `apt`). For other distributions, use the equivalent package manager (`dnf` on RHEL/Fedora, `apk` on Alpine).
+- A working Dockerfile if you are building a container image.
+- The Syncfusion XlsIO NuGet package installed and a valid license registered in your application.
## How to copy necessary fonts to Linux containers?
@@ -16,9 +24,9 @@ Excel to PDF conversion on Linux relies on system fonts available inside the con
**Steps:**
-Step 1: Create a **Fonts** folder inside your project (or next to the solution).
-Step 2: Place the required TrueType/OpenType font files (.ttf/.otf) in that folder.
-Step 3: Add the following to your Dockerfile to copy the fonts to the container.
+**Step 1:** Create a `Fonts` folder inside your project (or next to the solution).
+**Step 2:** Place the required TrueType or OpenType font files (`.ttf` or `.otf`) in that folder.
+**Step 3:** Add the following to your `Dockerfile` to copy the fonts into the container and rebuild the font cache.
{% tabs %}
@@ -34,7 +42,7 @@ You can download a complete working sample from ® license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
-{% tabs %}
-{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
+Include the following namespace in your `MainPage.aspx.cs` (or `MainPage.aspx.vb`) file.
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+{% endhighlight %}
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
+{% highlight vb.net tabtitle="VB.NET" %}
+Imports Syncfusion.XlsIO
+{% endhighlight %}
+{% endtabs %}
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add the `Syncfusion.Licensing` assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering the Syncfusion® license key in your applications to use our components.
+
+## Opening an existing workbook
+
+You can open an existing workbook by using the overloads of the [Open](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html#Syncfusion_XlsIO_IWorkbooks_Open_System_String_) methods of the [IWorkbooks](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html) interface.
+
+{% tabs %}
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
+
+ // Open an existing workbook through the Open method of IWorkbooks
+ IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
+}
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Creates a new instance for ExcelEngine
+' Create a new instance of ExcelEngine
Using excelEngine As New ExcelEngine()
-'Initialize IApplication
+' Initialize IApplication
Dim application As IApplication = excelEngine.Excel
-'Loads or open an existing workbook through Open method of IWorkbooks
+' Open an existing workbook through the Open method of IWorkbooks
Dim workbook As IWorkbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"))
End Using
{% endhighlight %}
@@ -38,47 +60,53 @@ End Using
## Saving an Excel workbook
-You can also save the created or manipulated workbook using overloads of [SaveAs](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbook.html#Syncfusion_XlsIO_IWorkbook_SaveAs_System_String_System_Web_HttpResponse_Syncfusion_XlsIO_ExcelDownloadType_Syncfusion_XlsIO_ExcelHttpContentType_) methods.
+You can save the created or manipulated workbook using the overloads of the [SaveAs](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbook.html#Syncfusion_XlsIO_IWorkbook_SaveAs_System_String_System_Web_HttpResponse_Syncfusion_XlsIO_ExcelDownloadType_Syncfusion_XlsIO_ExcelHttpContentType_) methods.
{% tabs %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+ // Open an existing workbook
+ IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
+ // To-Do: some manipulation
-//To-Do some manipulation
-//To-Do some manipulation
+ // Set the version of the workbook
+ workbook.Version = ExcelVersion.Xlsx;
-//Set the version of the workbook
-workbook.Version = ExcelVersion.Xlsx;
-
-//Save the workbook to disk in xlsx format
-workbook.SaveAs("Output.xlsx", Response, ExcelDownloadType.Open, ExcelHttpContentType.Excel2016);
+ // Stream the workbook to the HTTP response in xlsx format
+ workbook.SaveAs("Output.xlsx", Response, ExcelDownloadType.Open, ExcelHttpContentType.Excel2016);
+}
{% endhighlight %}
{% highlight vb tabtitle="VB.NET [Windows-specific]" %}
-'Creates a new instance for ExcelEngine
+' Create a new instance of ExcelEngine
Using excelEngine As New ExcelEngine()
-'Initialize IApplication
+' Initialize IApplication
Dim application As IApplication = excelEngine.Excel
-'Loads or open an existing workbook through Open method of IWorkbooks
+' Open an existing workbook through the Open method of IWorkbooks
Dim workbook As IWorkbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"))
-'To-Do some manipulation
-'To-Do some manipulation
+' To-Do: some manipulation
-'Set the version of the workbook
+' Set the version of the workbook
workbook.Version = ExcelVersion.Xlsx
-'Save the workbook to disk in xlsx format
+' Stream the workbook to the HTTP response in xlsx format
workbook.SaveAs("Output.xlsx", Response, ExcelDownloadType.Open, ExcelHttpContentType.Xlsx);
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
+
+## See Also
+
+* [Create, read, and edit Excel files in ASP.NET](https://help.syncfusion.com/document-processing/excel/excel-library/net/create-read-edit-excel-files-in-asp-net-c-sharp)
+* [Assemblies Required for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/assemblies-required)
+* [NuGet Packages for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required)
+* [Licensing Overview](https://help.syncfusion.com/document-processing/licensing/overview)
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-core-c-sharp.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-core-c-sharp.md
index 1ce9c513c3..14b22948f8 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-core-c-sharp.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-core-c-sharp.md
@@ -7,20 +7,38 @@ documentation: UG
---
# Loading and saving workbook in ASP.NET Core
+## Prerequisites
+
+* Visual Studio 2022 (17.0 or later) with the **ASP.NET and web development** workload installed.
+* .NET 8.0 SDK or later.
+* Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package in your ASP.NET Core project.
+* Register your Syncfusion® license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
+
+Include the following namespace in your `.cs` file.
+
+{% tabs %}
+{% highlight c# tabtitle="C# [Cross-platform]" %}
+using Syncfusion.XlsIO;
+{% endhighlight %}
+{% endtabs %}
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add the `Syncfusion.Licensing` assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering the Syncfusion® license key in your applications to use our components.
+
## Opening an existing workbook
You can open an existing workbook by using the overloads of [Open](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorkbooks.html#Syncfusion_XlsIO_IWorkbooks_Open_System_String_) methods of [IWorkbooks](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html) interface.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
-
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
+ // Open an existing workbook through the Open method of IWorkbooks
+ IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
+}
{% endhighlight %}
{% endtabs %}
@@ -30,22 +48,29 @@ You can also save the created or manipulated workbook using overloads of [SaveAs
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+ // Open an existing workbook
+ IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
+ // To-Do: some manipulation
-//To-Do some manipulation
-//To-Do some manipulation
+ // Set the version of the workbook
+ workbook.Version = ExcelVersion.Xlsx;
-//Set the version of the workbook
-workbook.Version = ExcelVersion.Xlsx;
-
-//Saving the workbook
-workbook.SaveAs("Output.xlsx");
+ // Save the workbook
+ workbook.SaveAs("Output.xlsx");
+}
{% endhighlight %}
{% endtabs %}
+
+## See Also
+
+* [Create, read, and edit Excel files in ASP.NET Core](https://help.syncfusion.com/document-processing/excel/excel-library/net/create-read-edit-excel-files-in-asp-net-core-c-sharp)
+* [Assemblies Required for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/assemblies-required)
+* [NuGet Packages for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required)
+* [Licensing Overview](https://help.syncfusion.com/document-processing/licensing/overview)
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-mvc-c-sharp.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-mvc-c-sharp.md
index 52db5ad5d6..b2f18f8e6a 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-mvc-c-sharp.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-asp-net-mvc-c-sharp.md
@@ -1,36 +1,58 @@
---
title: Loading and saving workbook in ASP.NET MVC | Syncfusion
-description: Explains how to load and save Excel files in ASP.NET MVC applications using .NET Excel Library.
+description: Learn how to load and save Excel files in ASP.NET MVC applications using the .NET Excel Library with simple and efficient file handling.
platform: document-processing
control: XlsIO
documentation: UG
---
# Loading and saving workbook in ASP.NET MVC
-## Opening an existing workbook
+## Prerequisites
-You can open an existing workbook by using the overloads of [Open](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html#Syncfusion_XlsIO_IWorkbooks_Open_System_String_) methods of [IWorkbooks](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html) interface.
+* Visual Studio 2017 or later with the **ASP.NET and web development** workload installed.
+* .NET Framework 4.6.1 or later.
+* Install the [Syncfusion.XlsIO.AspNet.Mvc5](https://www.nuget.org/packages/Syncfusion.XlsIO.AspNet.Mvc5) NuGet package (or `Syncfusion.XlsIO.AspNet.Mvc4` for MVC4) in your ASP.NET MVC project.
+* Register your Syncfusion® license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
-{% tabs %}
-{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
+Include the following namespace in your `HomeController.cs` (or `HomeController.vb`) file.
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+{% endhighlight %}
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
+{% highlight vb.net tabtitle="VB.NET" %}
+Imports Syncfusion.XlsIO
+{% endhighlight %}
+{% endtabs %}
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add the `Syncfusion.Licensing` assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering the Syncfusion® license key in your applications to use our components.
+
+## Opening an existing workbook
+
+You can open an existing workbook by using the overloads of the [Open](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html#Syncfusion_XlsIO_IWorkbooks_Open_System_String_) methods of the [IWorkbooks](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html) interface.
+
+{% tabs %}
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
+
+ // Open an existing workbook through the Open method of IWorkbooks
+ IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
+}
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Creates a new instance for ExcelEngine
+' Create a new instance of ExcelEngine
Using excelEngine As New ExcelEngine()
-'Initialize IApplication
+' Initialize IApplication
Dim application As IApplication = excelEngine.Excel
-'Loads or open an existing workbook through Open method of IWorkbooks
+' Open an existing workbook through the Open method of IWorkbooks
Dim workbook As IWorkbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"))
End Using
{% endhighlight %}
@@ -38,47 +60,53 @@ End Using
## Saving an Excel workbook
-You can also save the created or manipulated workbook using overloads of [SaveAs](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbook.html#Syncfusion_XlsIO_IWorkbook_SaveAs_System_String_System_Web_HttpResponse_Syncfusion_XlsIO_ExcelDownloadType_Syncfusion_XlsIO_ExcelHttpContentType_) methods.
+You can save the created or manipulated workbook using the overloads of the [SaveAs](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbook.html#Syncfusion_XlsIO_IWorkbook_SaveAs_System_String_System_Web_HttpResponse_Syncfusion_XlsIO_ExcelDownloadType_Syncfusion_XlsIO_ExcelHttpContentType_) methods.
{% tabs %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+ // Open an existing workbook
+ IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"));
+ // To-Do: some manipulation
-//To-Do some manipulation
-//To-Do some manipulation
+ // Set the version of the workbook
+ workbook.Version = ExcelVersion.Xlsx;
-//Set the version of the workbook
-workbook.Version = ExcelVersion.Xlsx;
-
-//Save the workbook to disk in xlsx format
-workbook.SaveAs("Output.xlsx", HttpContext.ApplicationInstance.Response, ExcelDownloadType.Open);
+ // Stream the workbook to the HTTP response in xlsx format
+ workbook.SaveAs("Output.xlsx", HttpContext.ApplicationInstance.Response, ExcelDownloadType.Open);
+}
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Creates a new instance for ExcelEngine
+' Create a new instance of ExcelEngine
Using excelEngine As New ExcelEngine()
-'Initialize IApplication
+' Initialize IApplication
Dim application As IApplication = excelEngine.Excel
-'Loads or open an existing workbook through Open method of IWorkbooks
+' Open an existing workbook through the Open method of IWorkbooks
Dim workbook As IWorkbook = application.Workbooks.Open(Server.MapPath("App_Data/Sample.xlsx"))
-'To-Do some manipulation
-'To-Do some manipulation
+' To-Do: some manipulation
-'Set the version of the workbook
+' Set the version of the workbook
workbook.Version = ExcelVersion.Xlsx
-'Save the workbook to disk in xlsx format
+' Stream the workbook to the HTTP response in xlsx format
workbook.SaveAs("Output.xlsx", HttpContext.ApplicationInstance.Response, ExcelDownloadType.Open)
End Using
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
+
+## See Also
+
+* [Create, read, and edit Excel files in ASP.NET MVC](https://help.syncfusion.com/document-processing/excel/excel-library/net/create-read-edit-excel-files-in-asp-net-mvc-c-sharp)
+* [Assemblies Required for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/assemblies-required)
+* [NuGet Packages for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required)
+* [Licensing Overview](https://help.syncfusion.com/document-processing/licensing/overview)
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-lambda.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-lambda.md
index 2c081992fe..88a7e93fa0 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-lambda.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-lambda.md
@@ -8,9 +8,15 @@ documentation: UG
# Loading and Saving Excel files in AWS Lambda
-Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core) used to create, read, edit and convert Excel documents programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **load and save an Excel document in AWS Lambda**.
+Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core) used to create, read, edit and convert Excel documents programmatically without **Microsoft Excel** or interop dependencies. This article explains how to **load and save an Excel file in AWS Lambda** using Syncfusion XlsIO.
-## Steps to Load and Save an Excel document in AWS Lambda
+## Prerequisites
+
+- An AWS account with permissions to create and invoke Lambda functions.
+- Visual Studio 2019 or later with the **AWS Toolkit for Visual Studio** extension installed.
+- A Syncfusion® license key. Refer to [How to register the Syncfusion license key](https://help.syncfusion.com/common/essential-studio/licensing/how-to-register-in-an-application) for details.
+
+## Steps to Load and Save an Excel file in AWS Lambda
Step 1: Create a new **AWS Lambda project** as follows.
@@ -18,7 +24,7 @@ Step 1: Create a new **AWS Lambda project** as follows.
Step 2: Name the application.
-
+
Step 3: Select Blueprint as Empty Function and click **Finish**.
@@ -26,15 +32,15 @@ Step 3: Select Blueprint as Empty Function and click **Finish**.
Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org).
-
+
-N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from the trial setup or from the NuGet feed, you must also add the **Syncfusion.Licensing** assembly reference and register a license key in your project. Refer to [How to register the Syncfusion license key](https://help.syncfusion.com/common/essential-studio/licensing/how-to-register-in-an-application) for details.
-Step 5: Create a folder and copy the required data files and include the files to the project.
+Step 5: Create a folder named **Data** in the project and copy the required template files (for example, `InputTemplate.xlsx`) into it. Include the files in the project.
-Step 6: Set the **copy to output directory** to **Copy if newer** to all the data files.
+Step 6: Set **Copy to Output Directory** to **Copy if newer** for all the data files so they are included in the deployment bundle.
@@ -56,7 +62,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
application.DefaultVersion = ExcelVersion.Xlsx;
string filePath = Path.Combine(Directory.GetCurrentDirectory(), "Data", "InputTemplate.xlsx");
- FileStream excelStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
+ using FileStream excelStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
IWorkbook workbook = application.Workbooks.Open(excelStream);
//Access first worksheet
@@ -80,15 +86,15 @@ Step 9: Right-click the project and select **Publish to AWS Lambda**.
-Step 10: Create a new AWS profile in the Upload Lambda Function Window. After creating the profile, add a name for the Lambda function to publish. Then, click **Next**.
+Step 10: In the **Upload Lambda Function** window, create a new AWS profile and enter a name for the Lambda function. Click **Next**.
-Step 11: In the Advanced Function Details window, specify the **Role Name** as based on AWS Managed policy. After selecting the role, click the **Upload** button to deploy your application.
+Step 11: In the **Advanced Function Details** window, select a **Role Name** that is backed by an AWS managed policy (for example, `AWSLambdaBasicExecutionRole`). Click **Upload** to deploy the application.
-Step 12: After deploying the application, you can see the published Lambda function in **AWS console**.
+Step 12: After the application is deployed, you can see the published Lambda function in the **AWS Lambda console**.
@@ -98,11 +104,13 @@ Step 13: Edit Memory size and Timeout as maximum in Basic settings of the AWS La
## Steps to post the request to AWS Lambda
-Step 1: Create a new console project.
+The following console application invokes the published AWS Lambda function and writes the returned Excel file to disk.
+
+Step 1: Create a new console project in Visual Studio.
-
+
-step 2: Install the following **NuGet packages** in your application from [Nuget.org](https://www.nuget.org/).
+Step 2: Install the following **NuGet packages** in your application from [NuGet.org](https://www.nuget.org/):
* [AWSSDK.Core](https://www.nuget.org/packages/AWSSDK.Core/)
* [AWSSDK.Lambda](https://www.nuget.org/packages/AWSSDK.Lambda/)
@@ -112,7 +120,7 @@ step 2: Install the following **NuGet packages** in your application from [Nuget
-Step 3: Include the following namespaces in **Program.cs** file.
+Step 3: Include the following namespaces in **Program.cs**.
{% tabs %}
{% highlight c# tabtitle="C#" %}
@@ -162,7 +170,7 @@ System.Diagnostics.Process.Start(psi);
{% endhighlight %}
{% endtabs %}
-By executing the program, you will get the **Excel document** as follows.
+By executing the program, you will get the **Excel document** as shown below.
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-s3-cloud-storage.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-s3-cloud-storage.md
index eda1b6b000..94daaa9183 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-s3-cloud-storage.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-aws-s3-cloud-storage.md
@@ -1,29 +1,34 @@
---
-title: Loading and saving Excel document in AWS S3 Cloud Storage | Syncfusion
-description: Explains how to load and save Excel files in AWS S3 Cloud Storage using .NET Core Excel (XlsIO) library without Microsoft Excel or interop dependencies.
+title: Loading and Saving Excel files in AWS S3 Cloud Storage | Syncfusion
+description: Explains how to load and save Excel files in AWS S3 Cloud Storage using the .NET Core Excel (XlsIO) library without Microsoft Excel or interop dependencies.
platform: document-processing
control: XlsIO
documentation: UG
---
-# Loading and Saving Excel document in AWS S3 Cloud Storage
+# Loading and Saving Excel files in AWS S3 Cloud Storage
-## Prerequisites
+This article explains how to **load an Excel file from AWS S3 Cloud Storage** and **save an Excel file to AWS S3 Cloud Storage** using Syncfusion XlsIO.
-* **[AWS S3 Cloud Storage](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)** is required.
+## Prerequisites
-## Loading Excel document from AWS S3
+* An AWS account with an **[Amazon S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)** and permission to read/write objects in it.
+* Visual Studio 2019 or later with the **ASP.NET and web development** workload.
+* AWS credentials (access key + secret key, or an attached IAM role).
+* A Syncfusion® license key. Refer to [How to register the Syncfusion license key](https://help.syncfusion.com/common/essential-studio/licensing/how-to-register-in-an-application) for details.
+
+## Loading Excel files from AWS S3
Steps to load an Excel document from AWS S3 Cloud Storage.
Step 1: Create a new ASP.NET Core Web Application (Model-View-Controller).
-
+
Step 2: Name the project.
-Step 3: Install the following **Nuget packages** in your application from [NuGet.org](https://www.nuget.org/).
+Step 3: Install the following **NuGet packages** in your application from [NuGet.org](https://www.nuget.org/).
* [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core)
* [AWSSDK.S3](https://www.nuget.org/packages/AWSSDK.S3)
@@ -65,9 +70,10 @@ string bucketName = "your-bucket-name";
//Name of the Excel file you want to load from AWS S3
string key = "CreateExcel.xlsx";
-// Configure AWS credentials and region
-var region = Amazon.RegionEndpoint.USEast1;
-var credentials = new Amazon.Runtime.BasicAWSCredentials("your-access-key", "your-secret-key");
+// Configure AWS credentials and region.
+// The default credentials provider chain picks up credentials from the environment,
+// the shared AWS credentials file, or an attached IAM role.
+var region = Amazon.RegionEndpoint.USEast1;
var config = new AmazonS3Config
{
RegionEndpoint = region
@@ -116,7 +122,7 @@ try
outputStream.Position = 0;
//Download the Excel file in the browser
- FileStreamResult fileStreamResult = new FileStreamResult(outputStream, "application/excel");
+ FileStreamResult fileStreamResult = new FileStreamResult(outputStream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
fileStreamResult.FileDownloadName = "EditExcel.xlsx";
return fileStreamResult;
}
@@ -137,19 +143,19 @@ By executing the program, you will get the **Excel document** as follows.
-## Saving Excel document to AWS S3
+## Saving Excel files to AWS S3
Steps to save an Excel document to AWS S3 Cloud Storage.
Step 1: Create a new ASP.NET Core Web Application (Model-View-Controller).
-
+
Step 2: Name the project.
-Step 3: Install the following **Nuget packages** in your application from [NuGet.org](https://www.nuget.org/).
+Step 3: Install the following **NuGet packages** in your application from [NuGet.org](https://www.nuget.org/).
* [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core)
* [AWSSDK.S3](https://www.nuget.org/packages/AWSSDK.S3)
@@ -181,7 +187,9 @@ using Syncfusion.Drawing;
{% endhighlight %}
{% endtabs %}
-Step 6: Include the below code snippet in **HomeController.cs** to **Save an Excel document to AWS S3 Storage**.
+Step 6: Register the Syncfusion license key (see the **Loading** section above) if you have not already done so.
+
+Step 7: Include the following code snippet in **HomeController.cs** to **save an Excel document to AWS S3 Storage**. The snippet is the body of the `CreateDocument` action method that the button in Step 4 posts to. The image file `AdventureCycles-Logo.png` must be present in the project and copied to the publish output.
{% tabs %}
{% highlight c# tabtitle="C#" %}
@@ -369,15 +377,16 @@ using (ExcelEngine excelEngine = new ExcelEngine())
//Name of the Excel file you want to upload
string keyName = "CreateExcel.xlsx";
- // Configure AWS credentials and region
- var region = RegionEndpoint.USEast1;
- var credentials = new Amazon.Runtime.BasicAWSCredentials("your-access-key", "your-secret-key");
+ // Configure AWS region.
+ // The default credentials provider chain picks up credentials from the environment,
+ // the shared AWS credentials file, or an attached IAM role.
+ var region = RegionEndpoint.USEast1;
var config = new AmazonS3Config
{
RegionEndpoint = region
};
- using (var client = new AmazonS3Client(credentials, config))
+ using (var client = new AmazonS3Client(config))
{
var fileTransferUtility = new TransferUtility(client);
@@ -403,7 +412,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
A complete working example of how to save an Excel document to AWS S3 Cloud Storage in ASP.NET Core is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/AWS/Saving/Create%20Excel).
-By executing the program, you will get the **Excel document** as follows.
+By executing the program, you will get the **Excel document** as shown below.
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-linux.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-linux.md
index 616ed7fc5f..9781d7b8c8 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-linux.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-linux.md
@@ -7,11 +7,19 @@ documentation: UG
---
# Loading and Saving Excel files in Azure App Service on Linux
-[.NET Excel Library for ASP.NET Core platform](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) can be used to create, read, edit Excel files in Azure App Service on Linux.
+[.NET Excel Library for ASP.NET Core platform](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) can be used to create, read, and edit Excel files in Azure App Service on Linux.
+
+## Prerequisites
+
+* An active Azure subscription with permission to create App Services.
+* Visual Studio 2022 (17.0 or later) with the **ASP.NET and web development** workload installed.
+* Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package in your project.
+* Register your Syncfusion® license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
+* A sample input file (for example, `Data/InputTemplate.xlsx`) added to the project and configured with **Build Action: Content** and **Copy to Output Directory: Copy if newer** so the file is deployed to Azure.
## Steps to Load and Save an Excel document in Azure App Service on Linux
-The below steps illustrates loading and saving a simple Invoice formatted Excel document in Azure App Service Linux.
+The steps below illustrate how to load and save a simple Invoice-formatted Excel document in Azure App Service on Linux.
Step 1: Create a new ASP.NET Core Web Application (Model-View-Controller).
@@ -25,11 +33,11 @@ Step 3: Select the framework and click **Create** button.
-Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org).
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as a reference to your ASP.NET Core application from [NuGet.org](https://www.nuget.org).
-N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add the "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering the Syncfusion® license key in your applications to use our components.
Step 5: Include the following namespaces in **HomeController.cs**.
@@ -56,38 +64,43 @@ Step 6: Add a new button in the **Index.cshtml** as shown below.
{% endhighlight %}
{% endtabs %}
-Step 7: Include the below code snippet in **HomeController.cs** to **load and save an Excel file and download it**.
+Step 7: Include the following code snippet in **HomeController.cs** to **load and save an Excel file and download it**.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C#" %}
-//Create an instance of ExcelEngine
-using (ExcelEngine excelEngine = new ExcelEngine())
+public ActionResult LoadingandSaving()
{
- IApplication application = excelEngine.Excel;
- application.DefaultVersion = ExcelVersion.Xlsx;
-
- //Load an existing Excel document
- FileStream inputStream = new FileStream("Data/InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
- IWorkbook workbook = application.Workbooks.Open(inputStream);
-
- //Access first worksheet from the workbook.
- IWorksheet worksheet = workbook.Worksheets[0];
-
- //Set Text in cell A3.
- worksheet.Range["A3"].Text = "Hello World";
-
- //Save the Excel to MemoryStream
- MemoryStream outputStream = new MemoryStream();
- workbook.SaveAs(outputStream);
-
- //Set the position
- outputStream.Position = 0;
-
- //Download the Excel document in the browser.
- return File(outputStream, "application/msexcel", "Output.xlsx");
+ // Create an instance of ExcelEngine
+ using (ExcelEngine excelEngine = new ExcelEngine())
+ {
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ // Load an existing Excel document
+ using (FileStream inputStream = new FileStream("Data/InputTemplate.xlsx", FileMode.Open, FileAccess.Read))
+ {
+ IWorkbook workbook = application.Workbooks.Open(inputStream);
+
+ // Access first worksheet from the workbook
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ // Set text in cell A3
+ worksheet.Range["A3"].Text = "Hello World";
+
+ // Save the Excel to a MemoryStream
+ using (MemoryStream outputStream = new MemoryStream())
+ {
+ workbook.SaveAs(outputStream);
+ outputStream.Position = 0;
+
+ // Download the Excel document in the browser
+ return File(outputStream, "application/msexcel", "Output.xlsx");
+ }
+ }
+ }
}
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
## Steps to publish as Azure App Service on Linux
@@ -123,11 +136,11 @@ Step 8: Click the **Publish** button.
-Step 9: Now, Publish has been succeeded.
+Step 9: The publish has succeeded.
-
+
-Step 10: Now, the published webpage will open in the browser.
+Step 10: The published web page opens in the browser.
@@ -135,8 +148,15 @@ Step 11: Click **Loading and Saving Document** to load and save a simple Excel d
-A complete working example of how to load and save an Excel document in Azure App Service on Linux in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20App%20Service/Loading%20and%20Saving).
+A complete working example of how to load and save an Excel document in Azure App Service on Linux in C# is available on the [SyncfusionExamples/XlsIO-Examples GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20App%20Service/Loading%20and%20Saving).
Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
-An online sample link to [create an Excel document](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) in ASP.NET Core.
\ No newline at end of file
+An online sample link to [create an Excel document in ASP.NET Core](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) is also available.
+
+## See Also
+
+* [Create, read, and edit Excel files in ASP.NET Core](https://help.syncfusion.com/document-processing/excel/excel-library/net/create-read-edit-excel-files-in-asp-net-core-c-sharp)
+* [Assemblies Required for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/assemblies-required)
+* [NuGet Packages for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required)
+* [Licensing Overview](https://help.syncfusion.com/document-processing/licensing/overview)
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-windows.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-windows.md
index 8459312006..f9c93efab7 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-windows.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-app-service-windows.md
@@ -7,11 +7,19 @@ documentation: UG
---
# Loading and Saving Excel files in Azure App Service on Windows
-[.NET Excel Library for ASP.NET Core platform](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) can be used to create, read, edit Excel files in Azure App Service on Windows.
+[.NET Excel Library for ASP.NET Core platform](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) can be used to create, read, and edit Excel files in Azure App Service on Windows.
+
+## Prerequisites
+
+* An active Azure subscription with permission to create App Services.
+* Visual Studio 2022 (17.0 or later) with the **ASP.NET and web development** workload installed.
+* Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package in your project.
+* Register your Syncfusion® license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
+* A sample input file (for example, `Data/InputTemplate.xlsx`) added to the project and configured with **Build Action: Content** and **Copy to Output Directory: Copy if newer** so the file is deployed to Azure.
## Steps to Load and Save an Excel document in Azure App Service on Windows
-The below steps illustrates loading and saving a simple Invoice formatted Excel document in Azure App Service Windows.
+The steps below illustrate how to load and save a simple Invoice-formatted Excel document in Azure App Service on Windows.
Step 1: Create a new ASP.NET Core Web Application (Model-View-Controller).
@@ -25,11 +33,11 @@ Step 3: Select the framework and click **Create** button.
-Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org).
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as a reference to your ASP.NET Core application from [NuGet.org](https://www.nuget.org).
-N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add the "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering the Syncfusion® license key in your applications to use our components.
Step 5: Include the following namespaces in **HomeController.cs**.
@@ -73,93 +81,100 @@ End Code
{% endhighlight %}
{% endtabs %}
-Step 7: Include the below code snippet in **HomeController.cs** to **load and save an Excel file and download it**.
+Step 7: Include the following code snippet in **HomeController.cs** to **load and save an Excel file and download it**.
-{% tabs %}
+{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Create an instance of ExcelEngine
-using (ExcelEngine excelEngine = new ExcelEngine())
+public ActionResult LoadingandSaving()
{
- IApplication application = excelEngine.Excel;
- application.DefaultVersion = ExcelVersion.Xlsx;
-
- //Load an existing Excel document
- IWorkbook workbook = application.Workbooks.Open("Data/InputTemplate.xlsx");
+ // Create an instance of ExcelEngine
+ using (ExcelEngine excelEngine = new ExcelEngine())
+ {
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
- //Access first worksheet from the workbook.
- IWorksheet worksheet = workbook.Worksheets[0];
+ // Load an existing Excel document
+ IWorkbook workbook = application.Workbooks.Open("Data/InputTemplate.xlsx");
- //Set Text in cell A3.
- worksheet.Range["A3"].Text = "Hello World";
+ // Access first worksheet from the workbook
+ IWorksheet worksheet = workbook.Worksheets[0];
- //Save the Excel to MemoryStream
- MemoryStream outputStream = new MemoryStream();
- workbook.SaveAs(outputStream);
+ // Set text in cell A3
+ worksheet.Range["A3"].Text = "Hello World";
- //Set the position
- outputStream.Position = 0;
+ // Save the Excel to a MemoryStream
+ using (MemoryStream outputStream = new MemoryStream())
+ {
+ workbook.SaveAs(outputStream);
+ outputStream.Position = 0;
- //Download the Excel document in the browser.
- return File(outputStream, "application/msexcel", "Output.xlsx");
+ // Download the Excel document in the browser
+ return File(outputStream, "application/msexcel", "Output.xlsx");
+ }
+ }
}
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
-//Create an instance of ExcelEngine
-using (ExcelEngine excelEngine = new ExcelEngine())
+public ActionResult LoadingandSaving()
{
- IApplication application = excelEngine.Excel;
- application.DefaultVersion = ExcelVersion.Xlsx;
+ //Create an instance of ExcelEngine
+ using (ExcelEngine excelEngine = new ExcelEngine())
+ {
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
- //Load an existing Excel document
- IWorkbook workbook = application.Workbooks.Open("Data/InputTemplate.xlsx");
+ //Load an existing Excel document
+ IWorkbook workbook = application.Workbooks.Open("Data/InputTemplate.xlsx");
- //Access first worksheet from the workbook.
- IWorksheet worksheet = workbook.Worksheets[0];
+ //Access first worksheet from the workbook.
+ IWorksheet worksheet = workbook.Worksheets[0];
- //Set Text in cell A3.
- worksheet.Range["A3"].Text = "Hello World";
+ //Set Text in cell A3.
+ worksheet.Range["A3"].Text = "Hello World";
- //Save the Excel to MemoryStream
- MemoryStream outputStream = new MemoryStream();
- workbook.SaveAs(outputStream);
+ //Save the Excel to MemoryStream
+ MemoryStream outputStream = new MemoryStream();
+ workbook.SaveAs(outputStream);
- //Set the position
- outputStream.Position = 0;
+ //Set the position
+ outputStream.Position = 0;
- //Download the Excel document in the browser.
- return File(outputStream, "application/msexcel", "Output.xlsx");
+ //Download the Excel document in the browser.
+ return File(outputStream, "application/msexcel", "Output.xlsx");
+ }
}
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
-'Create an instance of ExcelEngine
-Using excelEngine As New ExcelEngine()
- Dim application As IApplication = excelEngine.Excel
- application.DefaultVersion = ExcelVersion.Xlsx
-
- 'Load an existing Excel document
- Dim inputStream As New FileStream(Server.MapPath("~/Data/Input.xlsx"), FileMode.Open, FileAccess.Read)
- Dim workbook As IWorkbook = application.Workbooks.Open(inputStream)
-
- 'Access first worksheet
- Dim worksheet As IWorksheet = workbook.Worksheets(0)
-
- 'Set text in cell A3
- worksheet.Range("A3").Text = "Hello World"
-
- 'Save to memory stream
- Dim outputStream As New MemoryStream()
- workbook.SaveAs(outputStream)
-
- 'Reset position
- outputStream.Position = 0
-
- 'Download the Excel document
- Return File(outputStream, "application/msexcel", "Output.xlsx")
-End Using
+Public Function LoadingandSaving() As ActionResult
+ ' Create an instance of ExcelEngine
+ Using excelEngine As New ExcelEngine()
+ Dim application As IApplication = excelEngine.Excel
+ application.DefaultVersion = ExcelVersion.Xlsx
+
+ ' Load an existing Excel document
+ Dim inputStream As New FileStream(Server.MapPath("~/Data/InputTemplate.xlsx"), FileMode.Open, FileAccess.Read)
+ Dim workbook As IWorkbook = application.Workbooks.Open(inputStream)
+
+ ' Access first worksheet
+ Dim worksheet As IWorksheet = workbook.Worksheets(0)
+
+ ' Set text in cell A3
+ worksheet.Range("A3").Text = "Hello World"
+
+ ' Save to a memory stream
+ Using outputStream As New MemoryStream()
+ workbook.SaveAs(outputStream)
+ outputStream.Position = 0
+
+ ' Download the Excel document
+ Return File(outputStream, "application/msexcel", "Output.xlsx")
+ End Using
+ End Using
+End Function
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
## Steps to publish as Azure App Service on Windows
@@ -195,11 +210,11 @@ Step 8: Click the **Publish** button.
-Step 9: Now, Publish has been succeeded.
+Step 9: The publish has succeeded.
-
+
-Step 10: Now, the published webpage will open in the browser.
+Step 10: The published web page opens in the browser.
@@ -207,8 +222,15 @@ Step 11: Click **Loading and Saving Document** to load and save a simple Excel d
-A complete working example of how to load and save an Excel document in Azure App Service on Windows in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20App%20Service/Loading%20and%20Saving).
+A complete working example of how to load and save an Excel document in Azure App Service on Windows in C# is available on the [SyncfusionExamples/XlsIO-Examples GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20App%20Service/Loading%20and%20Saving).
Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
-An online sample link to [create an Excel document](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) in ASP.NET Core.
\ No newline at end of file
+An online sample link to [create an Excel document in ASP.NET Core](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) is also available.
+
+## See Also
+
+* [Create, read, and edit Excel files in ASP.NET Core](https://help.syncfusion.com/document-processing/excel/excel-library/net/create-read-edit-excel-files-in-asp-net-core-c-sharp)
+* [Assemblies Required for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/assemblies-required)
+* [NuGet Packages for XlsIO](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required)
+* [Licensing Overview](https://help.syncfusion.com/document-processing/licensing/overview)
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md
index 97e2333c1d..4d52176fc8 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md
@@ -5,12 +5,16 @@ platform: document-processing
control: XlsIO
documentation: UG
---
-# Loading and Saving Excel document in Azure Cloud Storage
+# Loading and Saving Excel files in Azure Cloud Storage
-## Prerequisites
-* **[Microsoft Azure subscription](https://portal.azure.com/#home)** is required.
+This article explains how to **load an Excel file from Azure Cloud Storage** and **save an Excel file to Azure Cloud Storage** using Syncfusion XlsIO.
-* **[Azure Cloud Storage](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json&tabs=azure-portal)** is required.
+## Prerequisites
+
+* An active **[Microsoft Azure subscription](https://portal.azure.com/#home)**.
+* An **[Azure Storage account](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json&tabs=azure-portal)** with a Blob container.
+* Visual Studio 2019 or later with the **ASP.NET and web development** workload.
+* A Syncfusion® license key. Refer to [How to register the Syncfusion license key](https://help.syncfusion.com/common/essential-studio/licensing/how-to-register-in-an-application) for details.
## Loading Excel document from Azure
@@ -102,7 +106,7 @@ try
outputStream.Position = 0;
//Download the Excel file in the browser
- FileStreamResult fileStreamResult = new FileStreamResult(outputStream, "application/excel");
+ FileStreamResult fileStreamResult = new FileStreamResult(outputStream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
fileStreamResult.FileDownloadName = "EditExcel.xlsx";
return fileStreamResult;
}
@@ -122,19 +126,19 @@ By executing the program, you will get the **Excel document** as follows.
-## Saving Excel document to Azure
+## Saving Excel files to Azure
Steps to save an Excel document to Azure Cloud Storage.
Step 1: Create a new ASP.NET Core Web Application (Model-View-Controller).
-
+
Step 2: Name the project.
-Step 3: Install the following **Nuget packages** in your application from [NuGet.org](https://www.nuget.org/).
+Step 3: Install the following **NuGet packages** in your application from [NuGet.org](https://www.nuget.org/).
* [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core)
* [Azure.Storage.Blobs](https://www.nuget.org/packages/Azure.Storage.Blobs)
@@ -142,7 +146,7 @@ Step 3: Install the following **Nuget packages** in your application from [NuGet
Step 4: Add a new button in the **Index.cshtml** as shown below.
-{% tabs %}
+{% tabs %}
{% highlight CSHTML %}
@{Html.BeginForm("CreateDocument", "Home", FormMethod.Get);
{
@@ -164,7 +168,9 @@ using Azure.Storage.Blobs;
{% endhighlight %}
{% endtabs %}
-Step 6: Include the below code snippet in **HomeController.cs** to **Save an Excel document to Azure Cloud Storage**.
+Step 6: Register the Syncfusion license key (see the **Loading** section above) if you have not already done so.
+
+Step 7: Include the following code snippet in **HomeController.cs** to **save an Excel document to Azure Cloud Storage**. The snippet is the body of the `CreateDocument` action method that the button in Step 4 posts to. The image file `AdventureCycles-Logo.png` must be present in the project and copied to the publish output.
{% tabs %}
{% highlight c# tabtitle="C#" %}
@@ -369,11 +375,10 @@ using (ExcelEngine excelEngine = new ExcelEngine())
A complete working example of how to save an Excel document to Azure Cloud Storage in ASP.NET Core is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20Blob%20Storage/Saving/Create%20Excel).
-By executing the program, you will get the **Excel document** as follows.
+By executing the program, you will get the **Excel document** as shown below.
Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
An online sample link to [create an Excel document](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) in ASP.NET Core.
-
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md
index 71074d7b2d..1643b917cd 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md
@@ -1,17 +1,17 @@
---
title: Loading and Saving Excel in Azure Functions v1 | Syncfusion
-description: Explains how to load and save an Excel files in Azure Functions v1 using Syncfusion Excel(XlsIO) library.
+description: Explains how to load and save Excel files in Azure Functions v1 using Syncfusion Excel(XlsIO) library.
platform: document-processing
control: XlsIO
documentation: UG
---
# Loading and Saving Excel files in Azure Functions v1
-Syncfusion® XlsIO is a [.NET Excel Library](https://www.syncfusion.com/document-processing/excel-framework/net) can be used to create, read, edit Excel files in Azure Functions v1.
+Syncfusion® XlsIO is a [.NET Excel Library](https://www.syncfusion.com/document-processing/excel-framework/net) that can be used to create, read, edit Excel files in Azure Functions v1.
## Steps to Load and Save an Excel document in Azure Functions v1
-The below steps illustrates loading and saving a simple Invoice formatted Excel document in Azure Functions v1.
+The following steps illustrate loading and saving a simple Invoice formatted Excel document in Azure Functions v1.
Step 1: Create a new Azure Functions project.
@@ -25,7 +25,7 @@ Step 3: Select the framework and click **Create** button.
-Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org).
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as a reference in your project from [NuGet.org](https://www.nuget.org).
@@ -37,7 +37,7 @@ Step 5: Include the following namespaces in the Function1.cs file.
{% highlight c# tabtitle="C#" %}
using Syncfusion.XlsIO;
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
Step 6: Add the following code snippet in **Run** method of **Function1** class to perform **Loading and Saving Excel files** in Azure Functions v1.
@@ -99,7 +99,7 @@ Step 12: Click the **Finish** button to finalize the **Azure Function** creation
-Step 13: Click **Close** button.
+Step 13: Click the **Close** button.
@@ -107,7 +107,7 @@ Step 14: Click the **Publish** button.
-Step 15: Publish has been succeeded.
+Step 15: Publishing has been completed.
@@ -148,7 +148,7 @@ try
//Write the Excel document stream into request stream
stream.Write(inputStream.ToArray(), 0, inputStream.ToArray().Length);
- //Gets the responce from the Azure Functions
+ //Gets the response from the Azure Functions
HttpWebResponse res = (HttpWebResponse)req.GetResponse();
//Saves the Excel stream
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md
index 56feb57128..8c543b5360 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md
@@ -1,17 +1,17 @@
---
title: Loading and Saving Excel in Azure Functions v4 | Syncfusion
-description: Explains how to load and save an Excel files in Azure Functions v4 using Syncfusion Excel(XlsIO) library.
+description: Explains how to load and save Excel files in Azure Functions v4 using Syncfusion Excel(XlsIO) library.
platform: document-processing
control: XlsIO
documentation: UG
---
# Loading and Saving Excel files in Azure Functions v4
-Syncfusion® XlsIO is a [.NET Excel Library](https://www.syncfusion.com/document-processing/excel-framework/net) can be used to create, read, edit Excel files in Azure Functions v4.
+Syncfusion® XlsIO is a [.NET Excel Library](https://www.syncfusion.com/document-processing/excel-framework/net) that can be used to create, read, edit Excel files in Azure Functions v4.
## Steps to Load and Save an Excel document in Azure Functions v4
-The below steps illustrates loading and saving a simple Invoice formatted Excel document in Azure Functions v4.
+The following steps illustrate loading and saving a simple invoice-formatted Excel document in Azure Functions v4.
Step 1: Create a new Azure Functions project.
@@ -25,7 +25,7 @@ Step 3: Select the framework and click **Create** button.
-Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org).
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as a reference in your project from [NuGet.org](https://www.nuget.org).
@@ -37,7 +37,7 @@ Step 5: Include the following namespaces in the Function1.cs file.
{% highlight c# tabtitle="C#" %}
using Syncfusion.XlsIO;
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
Step 6: Add the following code snippet in **Run** method of **Function1** class to perform **Loading and Saving Excel files** in Azure Functions v4.
@@ -99,7 +99,7 @@ Step 12: Click the **Finish** button to finalize the **Azure Function** creation
-Step 13: Click **Close** button.
+Step 13: Click the **Close** button.
@@ -107,7 +107,7 @@ Step 14: Click the **Publish** button.
-Step 15: Publish has been succeeded.
+Step 15: Publishing has been completed.
@@ -148,7 +148,7 @@ try
//Write the Excel document stream into request stream
stream.Write(inputStream.ToArray(), 0, inputStream.ToArray().Length);
- //Gets the responce from the Azure Functions
+ //Gets the response from the Azure Functions
HttpWebResponse res = (HttpWebResponse)req.GetResponse();
//Saves the Excel stream
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-blazor-c-sharp.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-blazor-c-sharp.md
index db4984409b..2f4bd90cb8 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-blazor-c-sharp.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-blazor-c-sharp.md
@@ -7,6 +7,16 @@ documentation: UG
---
# Loading and saving workbook in Blazor
+## Prerequisites
+
+* Visual Studio 2022 (17.0 or later) with the **ASP.NET and web development** workload installed.
+* .NET 8.0 SDK or later.
+* Create a Blazor Server App or Blazor WebAssembly App project.
+* Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package in your Blazor project.
+* Register your Syncfusion® license key in your project. Refer to the [licensing overview](https://help.syncfusion.com/document-processing/licensing/overview) for details.
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add the `Syncfusion.Licensing` assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/document-processing/licensing/overview) to know about registering the Syncfusion® license key in your applications to use our components.
+
## Opening an existing workbook
You can open an existing workbook by using the overloads of [Open](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorkbooks.html#Syncfusion_XlsIO_IWorkbooks_Open_System_String_) methods of [IWorkbooks](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbooks.html) interface.
@@ -15,105 +25,110 @@ The code snippet for this process in Blazor Server-Side application is given bel
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
-
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
+ // Open an existing workbook through the Open method of IWorkbooks
+ IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
+}
{% endhighlight %}
-{% endtabs %}
-
+{% endtabs %}
The code snippet for this process in Blazor Client-Side application is given below.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
-
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Load the file into stream
-Stream inputStream = await client.GetStreamAsync("sample-data/Sample.xlsx");
+ // Load the file into a stream
+ Stream inputStream = await client.GetStreamAsync("sample-data/Sample.xlsx");
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open(inputStream);
+ // Open an existing workbook through the Open method of IWorkbooks
+ IWorkbook workbook = application.Workbooks.Open(inputStream);
+}
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
## Saving an Excel workbook to stream
-You can also save the created or manipulated workbook to stream using overloads of [SaveAs](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbook.html#Syncfusion_XlsIO_IWorkbook_SaveAs_System_IO_Stream_) methods.
+You can save the created or manipulated workbook to a stream using the overloads of the [SaveAs](https://help.syncfusion.com/cr/file-formats/Syncfusion.XlsIO.IWorkbook.html#Syncfusion_XlsIO_IWorkbook_SaveAs_System_IO_Stream_) methods.
The code snippet for this process in Blazor Server-Side application is given below.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
-
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
+ // Open an existing workbook
+ IWorkbook workbook = application.Workbooks.Open("Sample.xlsx");
-//To-Do some manipulation
-//To-Do some manipulation
+ // To-Do: some manipulation
-//Set the version of the workbook
-workbook.Version = ExcelVersion.Xlsx;
+ // Set the version of the workbook
+ workbook.Version = ExcelVersion.Xlsx;
-//Save the document as a stream and retrun the stream.
-using (MemoryStream outputStream = new MemoryStream())
-{
- //Save the created Excel document to MemoryStream.
- workbook.SaveAs(outputStream);
+ // Save the document as a stream and return the stream
+ using (MemoryStream outputStream = new MemoryStream())
+ {
+ // Save the created Excel document to MemoryStream
+ workbook.SaveAs(outputStream);
+ outputStream.Position = 0;
- return outputStream;
+ return outputStream;
+ }
}
{% endhighlight %}
-{% endtabs %}
+{% endtabs %}
The code snippet for this process in Blazor Client-Side application is given below.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
-//Creates a new instance for ExcelEngine
-ExcelEngine excelEngine = new ExcelEngine();
-
-//Initialize IApplication
-IApplication application = excelEngine.Excel;
+// Create a new instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ // Initialize IApplication
+ IApplication application = excelEngine.Excel;
-//Load the file into stream
-Stream inputStream = await client.GetStreamAsync("sample-data/Sample.xlsx");
+ // Load the file into a stream
+ Stream inputStream = await client.GetStreamAsync("sample-data/Sample.xlsx");
-//Loads or open an existing workbook through Open method of IWorkbooks
-IWorkbook workbook = application.Workbooks.Open(inputStream);
+ // Open an existing workbook
+ IWorkbook workbook = application.Workbooks.Open(inputStream);
-//To-Do some manipulation
-//To-Do some manipulation
+ // To-Do: some manipulation
-//Set the version of the workbook
-workbook.Version = ExcelVersion.Xlsx;
+ // Set the version of the workbook
+ workbook.Version = ExcelVersion.Xlsx;
-//Save the document as a stream and retrun the stream.
-using (MemoryStream outputStream = new MemoryStream())
-{
- //Save the created Excel document to MemoryStream.
- workbook.SaveAs(outputStream);
+ // Save the document as a stream and return the stream
+ using (MemoryStream outputStream = new MemoryStream())
+ {
+ // Save the created Excel document to MemoryStream
+ workbook.SaveAs(outputStream);
+ outputStream.Position = 0;
- return outputStream;
+ return outputStream;
+ }
}
{% endhighlight %}
{% endtabs %}
## Helper Code Snippets
-Create a class file with name as ``FileUtils`` and add the following code to invoke the JavaScript action for downloading the file in browser.
+The following helper snippets are required to stream a `MemoryStream` to the browser as a file download. Add them once per Blazor project.
+
+**FileUtils.cs** — Create a class file named `FileUtils` (for example, under a `Helpers` folder) and add the following code to invoke the JavaScript action that downloads the file in the browser.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
@@ -128,26 +143,26 @@ public static class FileUtils
{% endhighlight %}
{% endtabs %}
-Add the following JavaScript function in the ``index.html`` file present under ``wwwroot``.
+**wwwroot/index.html** (Blazor WebAssembly) or **Pages/_Host.cshtml** (Blazor Server) — Add the following JavaScript function. The `saveAsFile` function is referenced by `FileUtils.SaveAs`.
{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}