Class DataSorter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Descrizione riassuntiva per DataSorter.
public class DataSorter
Ereditarietà
Membri ereditati
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Esempi
//Istanziamo un nuovo oggetto Workbook.
Workbook workbook = new Workbook("Book1.xls");
//Otteniamo l'oggetto datasorter del workbook.
DataSorter sorter = workbook.DataSorter;
//Impostiamo il primo ordine per l'oggetto datasorter.
sorter.Order1 = Aspose.Cells.SortOrder.Descending;
//Definiamo la prima chiave.
sorter.Key1 = 0;
//Impostiamo il secondo ordine per l'oggetto datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending;
//Definiamo la seconda chiave.
sorter.Key2 = 1;
//Creiamo un'area celle (intervallo).
CellArea ca = new CellArea();
//Specifichiamo l'indice della riga iniziale.
ca.StartRow = 0;
//Specifichiamo l'indice della colonna iniziale.
ca.StartColumn = 0;
//Specifichiamo l'indice dell'ultima riga.
ca.EndRow = 13;
//Specifichiamo l'indice dell'ultima colonna.
ca.EndColumn = 1;
//Ordiniamo i dati nell'intervallo di dati specificato (A1:B14)
sorter.Sort(workbook.Worksheets[0].Cells, ca);
//Salviamo il file excel.
workbook.Save("outBook.xls");
'Istanziamo un nuovo oggetto Workbook.
Dim workbook As Workbook = New Workbook("Book1.xls")
'Otteniamo l'oggetto datasorter del workbook.
Dim sorter As DataSorter = workbook.DataSorter
'Impostiamo il primo ordine per l'oggetto datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending
'Definiamo la prima chiave.
sorter.Key1 = 0
'Impostiamo il secondo ordine per l'oggetto datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending
'Definiamo la seconda chiave.
sorter.Key2 = 1
'Creiamo un'area celle (intervallo).
Dim ca As CellArea = New CellArea
'Spefichiamo l'indice della riga iniziale.
ca.StartRow = 0
'Spefichiamo l'indice della colonna iniziale.
ca.StartColumn = 0
'Spefichiamo l'indice dell'ultima riga.
ca.EndRow = 13
'Spefichiamo l'indice dell'ultima colonna.
ca.EndColumn = 1
'Ordiniamo i dati nell'intervallo di dati specificato (A1:B14)
sorter.Sort(workbook.Worksheets(0).Cells, ca)
'Salviamo il file excel.
workbook.Save("outBook.xls")
Proprietà
CaseSensitive
Ottiene e imposta se la comparazione delle stringhe è sensibile al maiuscolo.
public bool CaseSensitive { get; set; }
Valore della Proprietà
HasHeaders
Rappresenta se l’intervallo ha intestazioni.
public bool HasHeaders { get; set; }
Valore della Proprietà
Key1
Rappresenta l’indice della prima colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …).
public int Key1 { get; set; }
Valore della Proprietà
Key2
Rappresenta l’indice della seconda colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …).
public int Key2 { get; set; }
Valore della Proprietà
Key3
Rappresenta l’indice della terza colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …).
public int Key3 { get; set; }
Valore della Proprietà
Keys
Ottiene l’elenco delle chiavi del data sorter.
public DataSorterKeyCollection Keys { get; }
Valore della Proprietà
Order1
Rappresenta l’ordine di ordinamento della prima chiave.
public SortOrder Order1 { get; set; }
Valore della Proprietà
Order2
Rappresenta l’ordine di ordinamento della seconda chiave.
public SortOrder Order2 { get; set; }
Valore della Proprietà
Order3
Rappresenta l’ordine di ordinamento della terza chiave.
public SortOrder Order3 { get; set; }
Valore della Proprietà
SortAsNumber
Indica se si sta ordinando qualsiasi cosa che somigli a un numero.
public bool SortAsNumber { get; set; }
Valore della Proprietà
SortLeftToRight
True significa che l’orientamento di ordinamento è da sinistra a destra.
False significa che l’orientamento di ordinamento è dall’alto verso il basso.
Il valore predefinito è false.
public bool SortLeftToRight { get; set; }
Valore della Proprietà
Metodi
AddColorKey(int, SortOnType, SortOrder, Color)
Aggiunge una chiave di ordinamento per colore.
public void AddColorKey(int key, SortOnType type, SortOrder order, Color color)
Parametri
key
int
L’indice della colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …)
type
SortOnType
Il tipo di valore di colore ordinato.
order
SortOrder
L’ordine di ordinamento.
color
Color
Il colore di ordinamento personalizzato.
AddKey(int, SortOrder)
Aggiunge l’indice della colonna ordinata e l’ordine di ordinamento.
public void AddKey(int key, SortOrder order)
Parametri
key
int
L’indice della colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …)
order
SortOrder
L’ordine di ordinamento
AddKey(int, SortOrder, string)
Aggiunge l’indice della colonna ordinata e l’ordine di ordinamento con un elenco di ordinamento personalizzato.
public void AddKey(int key, SortOrder order, string customList)
Parametri
key
int
L’indice della colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …)
order
SortOrder
L’ordine di ordinamento.
customList
string
L’elenco di ordinamento personalizzato.
AddKey(int, SortOnType, SortOrder, object)
Aggiunge l’indice della colonna ordinata e l’ordine di ordinamento con un elenco di ordinamento personalizzato.
public void AddKey(int key, SortOnType type, SortOrder order, object customList)
Parametri
key
int
L’indice della colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …)
type
SortOnType
Il tipo di valore ordinato.
order
SortOrder
L’ordine di ordinamento.
customList
object
L’elenco di ordinamento personalizzato.
Osservazioni
Se il tipo è SortOnType.CellColor o SortOnType.FontColor, l’elenco personalizzato è Color.
AddKey(int, SortOrder, string[])
Aggiunge l’indice della colonna ordinata e l’ordine di ordinamento con un elenco di ordinamento personalizzato.
public void AddKey(int key, SortOrder order, string[] customList)
Parametri
key
int
L’indice della colonna ordinata (posizione assoluta, la colonna A è 0, B è 1, …)
order
SortOrder
L’ordine di ordinamento.
customList
string[]
L’elenco di ordinamento personalizzato.
Clear()
Cancella tutte le impostazioni.
public void Clear()
Sort(Cells, int, int, int, int)
Ordina i dati dell’area.
public int[] Sort(Cells cells, int startRow, int startColumn, int endRow, int endColumn)
Parametri
cells
Cells
Le celle contengono l’area dati.
startRow
int
La riga iniziale dell’area.
startColumn
int
La colonna iniziale dell’area.
endRow
int
La riga finale dell’area.
endColumn
int
La colonna finale dell’area.
Restituisce
int[]
gli indici originali (posizione assoluta, ad esempio, la colonna A è 0, B è 1, …) delle righe/colonne ordinate.
Se nessuna riga/colonna deve essere spostata da questa operazione di ordinamento, verrà restituito null.
Sort(Cells, CellArea)
Ordina i dati dell’area.
public int[] Sort(Cells cells, CellArea area)
Parametri
cells
Cells
Le celle contengono l’area dati.
area
CellArea
L’area da ordinare.
Restituisce
int[]
gli indici originali (posizione assoluta, ad esempio, la colonna A è 0, B è 1, …) delle righe/colonne ordinate.
Se nessuna riga/colonna deve essere spostata da questa operazione di ordinamento, verrà restituito null.
Sort()
Ordina i dati nell’intervallo.
public int[] Sort()
Restituisce
int[]
gli indici originali (posizione assoluta, ad esempio, la colonna A è 0, B è 1, …) delle righe/colonne ordinate.
Se nessuna riga/colonna deve essere spostata da questa operazione di ordinamento, verrà restituito null.