Class DataSorter

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

Краткое описание для DataSorter.

public class DataSorter

Наследование

object ← 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; }

Значение свойства

bool

HasHeaders

Представляет, имеет ли диапазон заголовки.

public bool HasHeaders { get; set; }

Значение свойства

bool

Key1

Представляет индекс первого сортируемого столбца (абсолютная позиция, столбец A - 0, B - 1, …).

public int Key1 { get; set; }

Значение свойства

int

Key2

Представляет индекс второго сортируемого столбца (абсолютная позиция, столбец A - 0, B - 1, …).

public int Key2 { get; set; }

Значение свойства

int

Key3

Представляет индекс третьего сортируемого столбца (абсолютная позиция, столбец A - 0, B - 1, …).

public int Key3 { get; set; }

Значение свойства

int

Keys

Получает список ключей сортировщика данных.

public DataSorterKeyCollection Keys { get; }

Значение свойства

DataSorterKeyCollection

Order1

Представляет порядок сортировки первого ключа.

public SortOrder Order1 { get; set; }

Значение свойства

SortOrder

Order2

Представляет порядок сортировки второго ключа.

public SortOrder Order2 { get; set; }

Значение свойства

SortOrder

Order3

Представляет порядок сортировки третьего ключа.

public SortOrder Order3 { get; set; }

Значение свойства

SortOrder

SortAsNumber

Указывает, сортировать ли все, что выглядит как число.

public bool SortAsNumber { get; set; }

Значение свойства

bool

SortLeftToRight

True означает, что ориентация сортировки слева направо.
False означает, что ориентация сортировки сверху вниз.
Значение по умолчанию - false.

public bool SortLeftToRight { get; set; }

Значение свойства

bool

Методы

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

Пользовательский список сортировки.

Примечания

Если type равен 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[]

Sort()

Сортирует данные в диапазоне.

public int[] Sort()

Возвращает

int[]