Class DataSorter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Короткий опис для DataSorter.
public class DataSorter
Спадкування
Спадковані члени
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Приклади
//Створіть новий об'єкт Workbook.
Workbook workbook = new Workbook("Book1.xls");
//Отримайте об'єкт datasorter для книги.
DataSorter sorter = workbook.DataSorter;
//Встановіть перший порядок для об'єкта datasorter.
sorter.Order1 = Aspose.Cells.SortOrder.Descending;
//Визначте перший ключ.
sorter.Key1 = 0;
//Встановіть другий порядок для об'єкта datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending;
//Визначте другий ключ.
sorter.Key2 = 1;
//Створіть область клітин (діапазон).
CellArea ca = new CellArea();
//Вкажіть індекс початкового рядка.
ca.StartRow = 0;
//Вкажіть індекс початкового стовпця.
ca.StartColumn = 0;
//Вкажіть індекс останнього рядка.
ca.EndRow = 13;
//Вкажіть індекс останнього стовпця.
ca.EndColumn = 1;
//Сортуйте дані у вказаному діапазоні даних (A1:B14)
sorter.Sort(workbook.Worksheets[0].Cells, ca);
//Збережіть файл excel.
workbook.Save("outBook.xls");
'Створіть новий об'єкт Workbook.
Dim workbook As Workbook = New Workbook("Book1.xls")
'Отримайте об'єкт datasorter для книги.
Dim sorter As DataSorter = workbook.DataSorter
'Встановіть перший порядок для об'єкта datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending
'Визначте перший ключ.
sorter.Key1 = 0
'Встановіть другий порядок для об'єкта datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending
'Визначте другий ключ.
sorter.Key2 = 1
'Створіть область клітин (діапазон).
Dim ca As CellArea = New CellArea
'Вкажіть індекс початкового рядка.
ca.StartRow = 0
'Вкажіть індекс початкового стовпця.
ca.StartColumn = 0
'Вкажіть індекс останнього рядка.
ca.EndRow = 13
'Вкажіть індекс останнього стовпця.
ca.EndColumn = 1
'Сортуйте дані у вказаному діапазоні даних (A1:B14)
sorter.Sort(workbook.Worksheets(0).Cells, ca)
'Збережіть файл excel.
workbook.Save("outBook.xls")
Властивості
CaseSensitive
Отримує або задає, чи є чутливим до регістру при порівнянні рядків.
public bool CaseSensitive { get; set; }
Значення властивості
HasHeaders
Представляє, чи має діапазон заголовки.
public bool HasHeaders { get; set; }
Значення властивості
Key1
Представляє індекс першого відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …).
public int Key1 { get; set; }
Значення властивості
Key2
Представляє індекс другого відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …).
public int Key2 { get; set; }
Значення властивості
Key3
Представляє індекс третього відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …).
public int Key3 { get; set; }
Значення властивості
Keys
Отримує список ключів для сортувальника даних.
public DataSorterKeyCollection Keys { get; }
Значення властивості
Order1
Представляє порядок сортування першого ключа.
public SortOrder Order1 { get; set; }
Значення властивості
Order2
Представляє порядок сортування другого ключа.
public SortOrder Order2 { get; set; }
Значення властивості
Order3
Представляє порядок сортування третього ключа.
public SortOrder Order3 { get; set; }
Значення властивості
SortAsNumber
Вказує, чи сортувати все, що виглядає як число.
public bool SortAsNumber { get; set; }
Значення властивості
SortLeftToRight
True означає, що орієнтація сортування зліва направо.
False означає, що орієнтація сортування зверху вниз.
Значення за замовчуванням - false.
public bool SortLeftToRight { get; set; }
Значення властивості
Методи
AddColorKey(int, SortOnType, SortOrder, Color)
Додає ключ сортування кольору.
public void AddColorKey(int key, SortOnType type, SortOrder order, Color color)
Параметри
key
int
Індекс відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …)
type
SortOnType
Тип значення кольору, що сортується.
order
SortOrder
Порядок сортування.
color
Color
Користувацький колір сортування.
AddKey(int, SortOrder)
Додає індекс відсортованого стовпця та порядок сортування.
public void AddKey(int key, SortOrder order)
Параметри
key
int
Індекс відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …)
order
SortOrder
Порядок сортування
AddKey(int, SortOrder, string)
Додає індекс відсортованого стовпця та порядок сортування з користувацьким списком сортування.
public void AddKey(int key, SortOrder order, string customList)
Параметри
key
int
Індекс відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …)
order
SortOrder
Порядок сортування.
customList
string
Користувацький список сортування.
AddKey(int, SortOnType, SortOrder, object)
Додає індекс відсортованого стовпця та порядок сортування з користувацьким списком сортування.
public void AddKey(int key, SortOnType type, SortOrder order, object customList)
Параметри
key
int
Індекс відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …)
type
SortOnType
Тип значення, що сортується.
order
SortOrder
Порядок сортування.
customList
object
Користувацький список сортування.
Примітки
Якщо тип - SortOnType.CellColor або SortOnType.FontColor, customList - це Color.
AddKey(int, SortOrder, string[])
Додає індекс відсортованого стовпця та порядок сортування з користувацьким списком сортування.
public void AddKey(int key, SortOrder order, string[] customList)
Параметри
key
int
Індекс відсортованого стовпця (абсолютна позиція, стовпець A - 0, B - 1, …)
order
SortOrder
Порядок сортування.
customList
string[]
Користувацький список сортування.
Clear()
Очистити всі налаштування.
public void Clear()
Sort(Cells, int, int, int, int)
Сортує дані області.
public int[] Sort(Cells cells, int startRow, int startColumn, int endRow, int endColumn)
Параметри
cells
Cells
Клітини, що містять область даних.
startRow
int
Початковий рядок області.
startColumn
int
Початковий стовпець області.
endRow
int
Останній рядок області.
endColumn
int
Останній стовпець області.
Повертає
int[]
оригінальні індекси (абсолютна позиція, наприклад, стовпець A - 0, B - 1, …) відсортованих рядків/стовпців.
Якщо жоден рядок/стовпець не потрібно переміщати за цією операцією сортування, буде повернуто null.
Sort(Cells, CellArea)
Сортує дані області.
public int[] Sort(Cells cells, CellArea area)
Параметри
cells
Cells
Клітини, що містять область даних.
area
CellArea
Область, яку потрібно відсортувати.
Повертає
int[]
оригінальні індекси (абсолютна позиція, наприклад, стовпець A - 0, B - 1, …) відсортованих рядків/стовпців.
Якщо жоден рядок/стовпець не потрібно переміщати за цією операцією сортування, буде повернуто null.
Sort()
Сортує дані в діапазоні.
public int[] Sort()
Повертає
int[]
оригінальні індекси (абсолютна позиція, наприклад, стовпець A - 0, B - 1, …) відсортованих рядків/стовпців.
Якщо жоден рядок/стовпець не потрібно переміщати за цією операцією сортування, буде повернуто null.