Class DataSorter

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

Descrição resumida para DataSorter.

public class DataSorter

Herança

object ← DataSorter

Membros Herdados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Exemplos

//Instanciar um novo objeto Workbook.
Workbook workbook = new Workbook("Book1.xls");
//Obter o objeto datasorter do workbook.
DataSorter sorter = workbook.DataSorter;
//Definir a primeira ordem para o objeto datasorter.
sorter.Order1 = Aspose.Cells.SortOrder.Descending;
//Definir a primeira chave.
sorter.Key1 = 0;
//Definir a segunda ordem para o objeto datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending;
//Definir a segunda chave.
sorter.Key2 = 1;
//Criar uma área de células (intervalo).
CellArea ca = new CellArea();
//Especificar o índice da linha inicial.
ca.StartRow = 0;
//Especificar o índice da coluna inicial.
ca.StartColumn = 0;
//Especificar o índice da última linha.
ca.EndRow = 13;
//Especificar o índice da última coluna.
ca.EndColumn = 1;
//Classificar os dados no intervalo de dados especificado (A1:B14)
sorter.Sort(workbook.Worksheets[0].Cells, ca);
//Salvar o arquivo excel.
workbook.Save("outBook.xls");

'Instanciar um novo objeto Workbook.
Dim workbook As Workbook = New Workbook("Book1.xls")
'Obter o objeto datasorter do workbook.
Dim sorter As DataSorter = workbook.DataSorter
'Definir a primeira ordem para o objeto datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending
'Definir a primeira chave.
sorter.Key1 = 0
'Definir a segunda ordem para o objeto datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending
'Definir a segunda chave.
sorter.Key2 = 1
'Criar uma área de células (intervalo).
Dim ca As CellArea = New CellArea
'Especificar o índice da linha inicial.
ca.StartRow = 0
'Especificar o índice da coluna inicial.
ca.StartColumn = 0
'Especificar o índice da última linha.
ca.EndRow = 13
'Especificar o índice da última coluna.
ca.EndColumn = 1
'Classificar os dados no intervalo de dados especificado (A1:B14)
sorter.Sort(workbook.Worksheets(0).Cells, ca)
'Salvar o arquivo excel.
workbook.Save("outBook.xls")

Propriedades

CaseSensitive

Obtém e define se a comparação de strings é sensível a maiúsculas e minúsculas.

public bool CaseSensitive { get; set; }

Valor da Propriedade

bool

HasHeaders

Representa se o intervalo possui cabeçalhos.

public bool HasHeaders { get; set; }

Valor da Propriedade

bool

Key1

Representa o índice da primeira coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …).

public int Key1 { get; set; }

Valor da Propriedade

int

Key2

Representa o índice da segunda coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …).

public int Key2 { get; set; }

Valor da Propriedade

int

Key3

Representa o índice da terceira coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …).

public int Key3 { get; set; }

Valor da Propriedade

int

Keys

Obtém a lista de chaves do data sorter.

public DataSorterKeyCollection Keys { get; }

Valor da Propriedade

DataSorterKeyCollection

Order1

Representa a ordem de classificação da primeira chave.

public SortOrder Order1 { get; set; }

Valor da Propriedade

SortOrder

Order2

Representa a ordem de classificação da segunda chave.

public SortOrder Order2 { get; set; }

Valor da Propriedade

SortOrder

Order3

Representa a ordem de classificação da terceira chave.

public SortOrder Order3 { get; set; }

Valor da Propriedade

SortOrder

SortAsNumber

Indica se deve classificar tudo que se parece com um número.

public bool SortAsNumber { get; set; }

Valor da Propriedade

bool

SortLeftToRight

True significa que a orientação da classificação é da esquerda para a direita.
False significa que a orientação da classificação é de cima para baixo.
O valor padrão é false.

public bool SortLeftToRight { get; set; }

Valor da Propriedade

bool

Métodos

AddColorKey(int, SortOnType, SortOrder, Color)

Adiciona uma chave de classificação por cor.

public void AddColorKey(int key, SortOnType type, SortOrder order, Color color)

Parâmetros

key int

O índice da coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …)

type SortOnType

O tipo de valor da cor ordenada.

order SortOrder

A ordem da classificação.

color Color

A cor de classificação personalizada.

AddKey(int, SortOrder)

Adiciona o índice da coluna ordenada e a ordem de classificação.

public void AddKey(int key, SortOrder order)

Parâmetros

key int

O índice da coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …)

order SortOrder

A ordem da classificação

AddKey(int, SortOrder, string)

Adiciona o índice da coluna ordenada e a ordem de classificação com uma lista de classificação personalizada.

public void AddKey(int key, SortOrder order, string customList)

Parâmetros

key int

O índice da coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …)

order SortOrder

A ordem da classificação.

customList string

A lista de classificação personalizada.

AddKey(int, SortOnType, SortOrder, object)

Adiciona o índice da coluna ordenada e a ordem de classificação com uma lista de classificação personalizada.

public void AddKey(int key, SortOnType type, SortOrder order, object customList)

Parâmetros

key int

O índice da coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …)

type SortOnType

O tipo de valor ordenado.

order SortOrder

A ordem da classificação.

customList object

A lista de classificação personalizada.

Observações

Se o tipo for SortOnType.CellColor ou SortOnType.FontColor, a customList é Color.

AddKey(int, SortOrder, string[])

Adiciona o índice da coluna ordenada e a ordem de classificação com uma lista de classificação personalizada.

public void AddKey(int key, SortOrder order, string[] customList)

Parâmetros

key int

O índice da coluna ordenada (posição absoluta, a coluna A é 0, B é 1, …)

order SortOrder

A ordem da classificação.

customList string[]

A lista de classificação personalizada.

Clear()

Limpa todas as configurações.

public void Clear()

Sort(Cells, int, int, int, int)

Classifica os dados da área.

public int[] Sort(Cells cells, int startRow, int startColumn, int endRow, int endColumn)

Parâmetros

cells Cells

As células contêm a área de dados.

startRow int

A linha inicial da área.

startColumn int

A coluna inicial da área.

endRow int

A linha final da área.

endColumn int

A coluna final da área.

Retorna

int[]

os índices originais (posição absoluta, por exemplo, a coluna A é 0, B é 1, …) das linhas/colunas ordenadas.
Se nenhuma linha/coluna precisar ser movida por esta operação de ordenação, null será retornado.

Sort(Cells, CellArea)

Classifica os dados da área.

public int[] Sort(Cells cells, CellArea area)

Parâmetros

cells Cells

As células contêm a área de dados.

area CellArea

A área que precisa ser ordenada.

Retorna

int[]

os índices originais (posição absoluta, por exemplo, a coluna A é 0, B é 1, …) das linhas/colunas ordenadas.
Se nenhuma linha/coluna precisar ser movida por esta operação de ordenação, null será retornado.

Sort()

Classifica os dados no intervalo.

public int[] Sort()

Retorna

int[]

os índices originais (posição absoluta, por exemplo, a coluna A é 0, B é 1, …) das linhas/colunas ordenadas.
Se nenhuma linha/coluna precisar ser movida por esta operação de ordenação, null será retornado.