Class DataSorter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Descripción resumen para DataSorter.
public class DataSorter
Herencia
Miembros heredados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Ejemplos
//Instanciar un nuevo objeto Workbook.
Workbook workbook = new Workbook("Book1.xls");
//Obtener el objeto datasorter del workbook.
DataSorter sorter = workbook.DataSorter;
//Establecer el primer orden para el objeto datasorter.
sorter.Order1 = Aspose.Cells.SortOrder.Descending;
//Definir la primera clave.
sorter.Key1 = 0;
//Establecer el segundo orden para el objeto datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending;
//Definir la segunda clave.
sorter.Key2 = 1;
//Crear un área de celdas (rango).
CellArea ca = new CellArea();
//Especificar el índice de la fila inicial.
ca.StartRow = 0;
//Especificar el índice de la columna inicial.
ca.StartColumn = 0;
//Especificar el índice de la última fila.
ca.EndRow = 13;
//Especificar el índice de la última columna.
ca.EndColumn = 1;
//Ordenar los datos en el rango de datos especificado (A1:B14)
sorter.Sort(workbook.Worksheets[0].Cells, ca);
//Guardar el archivo de excel.
workbook.Save("outBook.xls");
'Instanciar un nuevo objeto Workbook.
Dim workbook As Workbook = New Workbook("Book1.xls")
'Obtener el objeto datasorter del workbook.
Dim sorter As DataSorter = workbook.DataSorter
'Establecer el primer orden para el objeto datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending
'Definir la primera clave.
sorter.Key1 = 0
'Establecer el segundo orden para el objeto datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending
'Definir la segunda clave.
sorter.Key2 = 1
'Crear un área de celdas (rango).
Dim ca As CellArea = New CellArea
'Especificar el índice de la fila inicial.
ca.StartRow = 0
'Especificar el índice de la columna inicial.
ca.StartColumn = 0
'Especificar el índice de la última fila.
ca.EndRow = 13
'Especificar el índice de la última columna.
ca.EndColumn = 1
'Ordenar los datos en el rango de datos especificado (A1:B14)
sorter.Sort(workbook.Worksheets(0).Cells, ca)
'Guardar el archivo de excel.
workbook.Save("outBook.xls")
Propiedades
CaseSensitive
Obtiene y establece si es sensible a mayúsculas y minúsculas al comparar cadenas.
public bool CaseSensitive { get; set; }
Valor de la propiedad
HasHeaders
Representa si el rango tiene encabezados.
public bool HasHeaders { get; set; }
Valor de la propiedad
Key1
Representa el índice de la primera columna ordenada (posición absoluta, la columna A es 0, B es 1, …).
public int Key1 { get; set; }
Valor de la propiedad
Key2
Representa el índice de la segunda columna ordenada (posición absoluta, la columna A es 0, B es 1, …).
public int Key2 { get; set; }
Valor de la propiedad
Key3
Representa el índice de la tercera columna ordenada (posición absoluta, la columna A es 0, B es 1, …).
public int Key3 { get; set; }
Valor de la propiedad
Keys
Obtiene la lista de claves del ordenante de datos.
public DataSorterKeyCollection Keys { get; }
Valor de la propiedad
Order1
Representa el orden de clasificación de la primera clave.
public SortOrder Order1 { get; set; }
Valor de la propiedad
Order2
Representa el orden de clasificación de la segunda clave.
public SortOrder Order2 { get; set; }
Valor de la propiedad
Order3
Representa el orden de clasificación de la tercera clave.
public SortOrder Order3 { get; set; }
Valor de la propiedad
SortAsNumber
Indica si se ordena cualquier cosa que parezca un número.
public bool SortAsNumber { get; set; }
Valor de la propiedad
SortLeftToRight
True significa que la orientación de ordenación es de izquierda a derecha.
False significa que la orientación de ordenación es de arriba hacia abajo.
El valor predeterminado es false.
public bool SortLeftToRight { get; set; }
Valor de la propiedad
Métodos
AddColorKey(int, SortOnType, SortOrder, Color)
Agrega una clave de ordenación por color.
public void AddColorKey(int key, SortOnType type, SortOrder order, Color color)
Parámetros
key
int
El índice de la columna ordenada (posición absoluta, la columna A es 0, B es 1, …)
type
SortOnType
El tipo de valor de color ordenado.
order
SortOrder
El orden de clasificación.
color
Color
El color de ordenación personalizado.
AddKey(int, SortOrder)
Agrega el índice de la columna ordenada y el orden de clasificación.
public void AddKey(int key, SortOrder order)
Parámetros
key
int
El índice de la columna ordenada (posición absoluta, la columna A es 0, B es 1, …)
order
SortOrder
El orden de clasificación
AddKey(int, SortOrder, string)
Agrega el índice de la columna ordenada y el orden de clasificación con una lista de ordenación personalizada.
public void AddKey(int key, SortOrder order, string customList)
Parámetros
key
int
El índice de la columna ordenada (posición absoluta, la columna A es 0, B es 1, …)
order
SortOrder
El orden de clasificación.
customList
string
La lista de ordenación personalizada.
AddKey(int, SortOnType, SortOrder, object)
Agrega el índice de la columna ordenada y el orden de clasificación con una lista de ordenación personalizada.
public void AddKey(int key, SortOnType type, SortOrder order, object customList)
Parámetros
key
int
El índice de la columna ordenada (posición absoluta, la columna A es 0, B es 1, …)
type
SortOnType
El tipo de valor ordenado.
order
SortOrder
El orden de clasificación.
customList
object
La lista de ordenación personalizada.
Notas
Si el tipo es SortOnType.CellColor o SortOnType.FontColor, la customList es Color.
AddKey(int, SortOrder, string[])
Agrega el índice de la columna ordenada y el orden de clasificación con una lista de ordenación personalizada.
public void AddKey(int key, SortOrder order, string[] customList)
Parámetros
key
int
El índice de la columna ordenada (posición absoluta, la columna A es 0, B es 1, …)
order
SortOrder
El orden de clasificación.
customList
string[]
La lista de ordenación personalizada.
Clear()
Limpiar todas las configuraciones.
public void Clear()
Sort(Cells, int, int, int, int)
Ordena los datos del área.
public int[] Sort(Cells cells, int startRow, int startColumn, int endRow, int endColumn)
Parámetros
cells
Cells
Las celdas que contienen el área de datos.
startRow
int
La fila inicial del área.
startColumn
int
La columna inicial del área.
endRow
int
La fila final del área.
endColumn
int
La columna final del área.
Retorna
int[]
los índices originales (posición absoluta, por ejemplo, la columna A es 0, B es 1, …) de las filas/columnas ordenadas.
Si no se necesitan mover filas/columnas por esta operación de ordenación, se devolverá null.
Sort(Cells, CellArea)
Ordena los datos del área.
public int[] Sort(Cells cells, CellArea area)
Parámetros
cells
Cells
Las celdas que contienen el área de datos.
area
CellArea
El área que necesita ser ordenada
Retorna
int[]
los índices originales (posición absoluta, por ejemplo, la columna A es 0, B es 1, …) de las filas/columnas ordenadas.
Si no se necesitan mover filas/columnas por esta operación de ordenación, se devolverá null.
Sort()
Ordena los datos en el rango.
public int[] Sort()
Retorna
int[]
los índices originales (posición absoluta, por ejemplo, la columna A es 0, B es 1, …) de las filas/columnas ordenadas.
Si no se necesitan mover filas/columnas por esta operación de ordenación, se devolverá null.