Class DataSorter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Description sommaire pour DataSorter.
public class DataSorterHéritage
Membres hérités
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exemples
//Instancier un nouvel objet Workbook.
Workbook workbook = new Workbook("Book1.xls");
//Obtenir l'objet datasorter du classeur.
DataSorter sorter = workbook.DataSorter;
//Définir le premier ordre pour l'objet datasorter.
sorter.Order1 = Aspose.Cells.SortOrder.Descending;
//Définir la première clé.
sorter.Key1 = 0;
//Définir le deuxième ordre pour l'objet datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending;
//Définir la deuxième clé.
sorter.Key2 = 1;
//Créer une zone de cellules (plage).
CellArea ca = new CellArea();
//Spécifier l'index de la ligne de départ.
ca.StartRow = 0;
//Spécifier l'index de la colonne de départ.
ca.StartColumn = 0;
//Spécifier l'index de la dernière ligne.
ca.EndRow = 13;
//Spécifier l'index de la dernière colonne.
ca.EndColumn = 1;
//Trier les données dans la plage de données spécifiée (A1:B14)
sorter.Sort(workbook.Worksheets[0].Cells, ca);
//Enregistrer le fichier excel.
workbook.Save("outBook.xls");'Instancier un nouvel objet Workbook.
Dim workbook As Workbook = New Workbook("Book1.xls")
'Obtenir l'objet datasorter du classeur.
Dim sorter As DataSorter = workbook.DataSorter
'Définir le premier ordre pour l'objet datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending
'Définir la première clé.
sorter.Key1 = 0
'Définir le deuxième ordre pour l'objet datasorter.
sorter.Order2 = Aspose.Cells.SortOrder.Ascending
'Définir la deuxième clé.
sorter.Key2 = 1
'Créer une zone de cellules (plage).
Dim ca As CellArea = New CellArea
'Spécifier l'index de la ligne de départ.
ca.StartRow = 0
'Spécifier l'index de la colonne de départ.
ca.StartColumn = 0
'Spécifier l'index de la dernière ligne.
ca.EndRow = 13
'Spécifier l'index de la dernière colonne.
ca.EndColumn = 1
'Trier les données dans la plage de données spécifiée (A1:B14)
sorter.Sort(workbook.Worksheets(0).Cells, ca)
'Enregistrer le fichier excel.
workbook.Save("outBook.xls")Propriétés
CaseSensitive
Obtient et définit si la comparaison de chaînes est sensible à la casse.
public bool CaseSensitive { get; set; }Valeur de propriété
HasHeaders
Représente si la plage a des en-têtes.
public bool HasHeaders { get; set; }Valeur de propriété
Key1
Représente l’index de la première colonne triée (position absolue, la colonne A est 0, B est 1, …).
public int Key1 { get; set; }Valeur de propriété
Key2
Représente l’index de la deuxième colonne triée (position absolue, la colonne A est 0, B est 1, …).
public int Key2 { get; set; }Valeur de propriété
Key3
Représente l’index de la troisième colonne triée (position absolue, la colonne A est 0, B est 1, …).
public int Key3 { get; set; }Valeur de propriété
Keys
Obtient la liste des clés du tri des données.
public DataSorterKeyCollection Keys { get; }Valeur de propriété
Order1
Représente l’ordre de tri de la première clé.
public SortOrder Order1 { get; set; }Valeur de propriété
Order2
Représente l’ordre de tri de la deuxième clé.
public SortOrder Order2 { get; set; }Valeur de propriété
Order3
Représente l’ordre de tri de la troisième clé.
public SortOrder Order3 { get; set; }Valeur de propriété
SortAsNumber
Indique si le tri doit être effectué sur tout ce qui ressemble à un nombre.
public bool SortAsNumber { get; set; }Valeur de propriété
SortLeftToRight
Vrai signifie que l’orientation du tri est de gauche à droite.
Faux signifie que l’orientation du tri est de haut en bas.
La valeur par défaut est faux.
public bool SortLeftToRight { get; set; }Valeur de propriété
Méthodes
AddColorKey(int, SortOnType, SortOrder, Color)
Ajoute une clé de tri de couleur.
public void AddColorKey(int key, SortOnType type, SortOrder order, Color color)Paramètres
key int
L’index de la colonne triée (position absolue, la colonne A est 0, B est 1, …)
type SortOnType
Le type de valeur de couleur triée.
order SortOrder
L’ordre de tri.
color Color
La couleur de tri personnalisée.
AddKey(int, SortOrder)
Ajoute l’index de colonne triée et l’ordre de tri.
public void AddKey(int key, SortOrder order)Paramètres
key int
L’index de colonne triée (position absolue, la colonne A est 0, B est 1, …)
order SortOrder
L’ordre de tri
AddKey(int, SortOrder, string)
Ajoute l’index de colonne triée et l’ordre de tri avec une liste de tri personnalisée.
public void AddKey(int key, SortOrder order, string customList)Paramètres
key int
L’index de colonne triée (position absolue, la colonne A est 0, B est 1, …)
order SortOrder
L’ordre de tri.
customList string
La liste de tri personnalisée.
AddKey(int, SortOnType, SortOrder, object)
Ajoute l’index de colonne triée et l’ordre de tri avec une liste de tri personnalisée.
public void AddKey(int key, SortOnType type, SortOrder order, object customList)Paramètres
key int
L’index de colonne triée (position absolue, la colonne A est 0, B est 1, …)
type SortOnType
Le type de valeur triée.
order SortOrder
L’ordre de tri.
customList object
La liste de tri personnalisée.
Remarques
Si le type est SortOnType.CellColor ou SortOnType.FontColor, customList est Color.
AddKey(int, SortOrder, string[])
Ajoute l’index de colonne triée et l’ordre de tri avec une liste de tri personnalisée.
public void AddKey(int key, SortOrder order, string[] customList)Paramètres
key int
L’index de colonne triée (position absolue, la colonne A est 0, B est 1, …)
order SortOrder
L’ordre de tri.
customList string[]
La liste de tri personnalisée.
Clear()
Efface tous les paramètres.
public void Clear()Sort(Cells, int, int, int, int)
Trie les données de la zone.
public int[] Sort(Cells cells, int startRow, int startColumn, int endRow, int endColumn)Paramètres
cells Cells
Les cellules contenant la zone de données.
startRow int
La ligne de départ de la zone.
startColumn int
La colonne de départ de la zone.
endRow int
La dernière ligne de la zone.
endColumn int
La dernière colonne de la zone.
Retourne
int[]
les indices originaux (position absolue, par exemple, la colonne A est 0, B est 1, …) des lignes/colonnes triées.
Si aucune ligne/colonne n’a besoin d’être déplacée par cette opération de tri, null sera retourné.
Sort(Cells, CellArea)
Trie les données de la zone.
public int[] Sort(Cells cells, CellArea area)Paramètres
cells Cells
Les cellules contenant la zone de données.
area CellArea
La zone à trier
Retourne
int[]
les indices originaux (position absolue, par exemple, la colonne A est 0, B est 1, …) des lignes/colonnes triées.
Si aucune ligne/colonne n’a besoin d’être déplacée par cette opération de tri, null sera retourné.
Sort()
Trie les données dans la plage.
public int[] Sort()Retourne
int[]
les indices originaux (position absolue, par exemple, la colonne A est 0, B est 1, …) des lignes/colonnes triées.
Si aucune ligne/colonne n’a besoin d’être déplacée par cette opération de tri, null sera retourné.
