Data Sorting
Sorting Data in Microsoft Excel
To sort data in Microsoft Excel:
- Select Data from the Sort menu. The Sort dialog will be displayed.
- Select a sorting option.
Generally, sorting is performed on a list - defined as a contiguous group of data where the data is displayed in columns.
Sorting Data with Aspose.Cells
Aspose.Cells provides the DataSorter class used to sort data in ascending or descending order. The class has some important members, for example, properties like Key1 … Key3 and Order1 … Order3. These members are used to define sorted keys and specify the key sort order.
You have to define keys and set the sort order before implementing data sorting. The class provides the Sort method used to perform data sorting based on the cell data in a worksheet.
The Sort method accepts the following parameters:
- Aspose.Cells.Cells, the cells for the underlying worksheet.
- Aspose.Cells.CellArea, the range of cells. Define the cell area before applying data sorting.
This example uses the template file “Book1.xls” created in Microsoft Excel. After executing the code below, data is sorted appropriately.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiate a new Workbook object. | |
// Load a template file. | |
Workbook workbook = new Workbook(dataDir + "book1.xls"); | |
// Get the workbook datasorter object. | |
DataSorter sorter = workbook.DataSorter; | |
// Set the first order for datasorter object. | |
sorter.Order1 = Aspose.Cells.SortOrder.Descending; | |
// Define the first key. | |
sorter.Key1 = 0; | |
// Set the second order for datasorter object. | |
sorter.Order2 = Aspose.Cells.SortOrder.Ascending; | |
// Define the second key. | |
sorter.Key2 = 1; | |
// Create a cells area (range). | |
CellArea ca = new CellArea(); | |
// Specify the start row index. | |
ca.StartRow = 0; | |
// Specify the start column index. | |
ca.StartColumn = 0; | |
// Specify the last row index. | |
ca.EndRow = 13; | |
// Specify the last column index. | |
ca.EndColumn = 1; | |
// Sort data in the specified data range (A1:B14) | |
sorter.Sort(workbook.Worksheets[0].Cells, ca); | |
// Save the excel file. | |
workbook.Save(dataDir + "output.out.xls"); |
Sorting data with background color
Excel provides features to sort data based on the background color. The same feature is provided using Aspose.Cells using DataSorter where SortOnType.CellColor can be used in AddKey() to sort data based on the background color. All the cells which contain specified color in the AddKey(), function are placed on top or bottom according to the SortOrder setting and order of the rest of the cells is not changed at all.
Following are the sample files which can be downloaded for testing this feature:
outputsampleBackGroundFile.xlsx
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// Create a workbook object and load template file | |
Workbook workbook = new Workbook(sourceDir + "CellsNet46500.xlsx"); | |
// Instantiate data sorter object | |
DataSorter sorter = workbook.DataSorter; | |
// Add key for second column for red color | |
sorter.AddKey(1, SortOnType.CellColor, SortOrder.Descending, Color.Red); | |
// Sort the data based on the key | |
sorter.Sort(workbook.Worksheets[0].Cells, CellArea.CreateCellArea("A2", "C6")); | |
// Save the output file | |
workbook.Save(outputDir + "outputSortData_CustomSortList.xlsx"); |