Class AutoFilter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Représente le filtrage automatique pour la feuille de calcul spécifiée.
public class AutoFilter
Hé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
//Création d'un flux de fichier contenant le fichier Excel à ouvrir
//Instanciation d'un objet Workbook
Workbook workbook = new Workbook("template.xlsx");
//Accès à la première feuille de calcul dans le fichier Excel
Worksheet worksheet = workbook.Worksheets[0];
//Création d'un AutoFilter en donnant la plage de cellules de la ligne d'en-tête
worksheet.AutoFilter.Range = "A1:B1";
//Filtrage des colonnes avec des valeurs spécifiées
worksheet.AutoFilter.Filter(1, "Bananes");
//Enregistrement du fichier Excel modifié.
workbook.Save("output.xls");
'Création d'un flux de fichier contenant le fichier Excel à ouvrir
'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook("template.xlsx")
'Accès à la première feuille de calcul dans le fichier Excel
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Création d'un AutoFilter en donnant la plage de cellules de la ligne d'en-tête
worksheet.AutoFilter.Range = "A1:B1"
'Filtrage des colonnes avec des valeurs spécifiées
Worksheet.AutoFilter.Filter(1, "Bananes")
'Enregistrement du fichier Excel modifié
workbook.Save("output.xls")
Propriétés
FilterColumns
Obtient la collection des colonnes de filtre.
public FilterColumnCollection FilterColumns { get; }
Valeur de propriété
Range
Représente la plage à laquelle le filtre automatique spécifié s’applique.
public string Range { get; set; }
Valeur de propriété
ShowFilterButton
Indique si le bouton de filtre automatique pour cette colonne est visible.
public bool ShowFilterButton { get; set; }
Valeur de propriété
Sorter
Obtient le tri des données.
public DataSorter Sorter { get; }
Valeur de propriété
Méthodes
AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Ajoute un filtre de date.
public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
dateTimeGroupingType
DateTimeGroupingType
Le type de regroupement
year
int
L’année.
month
int
Le mois.
day
int
Le jour.
hour
int
L’heure.
minute
int
La minute.
second
int
La seconde.
Remarques
Si DateTimeGroupingType est Année, seul le paramètre année a un effet. Si DateTimeGroupingType est Mois, seuls les paramètres année et mois ont un effet.
AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)
Ajoute un filtre de couleur de remplissage.
public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
pattern
BackgroundType
Le type de motif de fond.
foregroundColor
CellsColor
La couleur de premier plan.
backgroundColor
CellsColor
La couleur de fond.
AddFilter(int, string)
Ajoute un filtre pour une colonne de filtre.
public void AddFilter(int fieldIndex, string criteria)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
criteria
string
Les critères spécifiés (une chaîne ; par exemple, “101”). Cela ne peut être que null ou l’une des valeurs des cellules dans cette colonne.
Remarques
MS Excel 2007 prend en charge la sélection multiple dans une colonne de filtre.
AddFontColorFilter(int, CellsColor)
Ajoute un filtre de couleur de police.
public void AddFontColorFilter(int fieldIndex, CellsColor color)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
color
CellsColor
L’objet Aspose.Cells.CellsColor.
AddIconFilter(int, IconSetType, int)
Ajoute un filtre d’icône.
public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
iconSetType
IconSetType
Le type d’ensemble d’icônes.
iconId
int
L’identifiant de l’icône.
Remarques
Ne prend en charge que l’ajout du filtre d’icône. Ne prend pas en charge la vérification de quelle ligne est visible si le filtre est un filtre d’icône.
Custom(int, FilterOperatorType, object)
Filtre une liste avec des critères personnalisés.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
operatorType1
FilterOperatorType
Le type d’opérateur de filtre
criteria1
object
Les critères personnalisés
Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)
Filtre une liste avec des critères personnalisés.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
operatorType1
FilterOperatorType
Le type d’opérateur de filtre
criteria1
object
Les critères personnalisés
isAnd
bool
operatorType2
FilterOperatorType
Le type d’opérateur de filtre
criteria2
object
Les critères personnalisés
DynamicFilter(int, DynamicFilterType)
Ajoute un filtre dynamique.
public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
dynamicFilterType
DynamicFilterType
Type de filtre dynamique.
Filter(int, string)
Filtre une liste avec des critères spécifiés.
public void Filter(int fieldIndex, string criteria)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
criteria
string
Les critères spécifiés (une chaîne ; par exemple, “101”).
Remarques
Aspose.Cells supprimera tous les autres paramètres de filtre sur ce champ comme Ms Excel 97-2003.
FilterTop10(int, bool, bool, int)
Filtre les 10 premiers éléments de la liste
public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
isTop
bool
Indique si le filtre provient du haut ou du bas
isPercent
bool
Indique si les éléments sont en pourcentage ou en nombre
itemCount
int
Le nombre d’éléments
GetCellArea()
Obtient l’Aspose.Cells.CellArea auquel ce filtre automatique s’applique.
public CellArea GetCellArea()
Retourne
la zone à laquelle ce filtre s’applique
GetCellArea(bool)
Obtient l’Aspose.Cells.CellArea auquel le filtre automatique spécifié s’applique.
public CellArea GetCellArea(bool refreshAppliedRange)
Paramètres
refreshAppliedRange
bool
Si le dernier rang doit être rafraîchi. Pour la plage appliquée du filtre automatique, la dernière ligne peut changer lorsque les données des cellules changent. Si ce drapeau est vrai, alors la dernière ligne de la plage sera recalculée selon les données actuelles des cellules.
Retourne
la zone à laquelle ce filtre s’applique
MatchBlanks(int)
Correspond à toutes les cellules vides dans la liste.
public void MatchBlanks(int fieldIndex)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
MatchNonBlanks(int)
Correspond à toutes les cellules non vides dans la liste.
public void MatchNonBlanks(int fieldIndex)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
Refresh()
Rafraîchit les filtres automatiques pour masquer ou afficher les lignes.
public int[] Refresh()
Retourne
int[]
Retourne tous les index des lignes masquées.
Refresh(bool)
Obtient tous les index des lignes masquées.
public int[] Refresh(bool hideRows)
Paramètres
hideRows
bool
Si vrai, masque les lignes filtrées.
Retourne
int[]
Retourne tous les index des lignes masquées.
RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Supprime un filtre de date.
public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
dateTimeGroupingType
DateTimeGroupingType
Le type de regroupement
year
int
L’année.
month
int
Le mois.
day
int
Le jour.
hour
int
L’heure.
minute
int
La minute.
second
int
La seconde.
Remarques
Si DateTimeGroupingType est Année, seul le paramètre année a un effet. Si DateTimeGroupingType est Mois, seuls les paramètres année et mois ont un effet.
RemoveFilter(int, string)
Supprime un filtre pour une colonne de filtre.
public void RemoveFilter(int fieldIndex, string criteria)
Paramètres
fieldIndex
int
Le décalage entier du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste ; le champ le plus à gauche est le champ 0).
criteria
string
Les critères spécifiés (une chaîne ; par exemple, “101”). Cela ne peut être que null ou l’une des valeurs des cellules dans cette colonne.
RemoveFilter(int)
Supprime le filtre spécifique.
public void RemoveFilter(int fieldIndex)
Paramètres
fieldIndex
int
L’index du filtre spécifique
SetRange(int, int, int)
Définit la plage à laquelle le filtre automatique spécifié s’applique.
public void SetRange(int row, int startColumn, int endColumn)
Paramètres
row
int
Index de ligne.
startColumn
int
Index de la colonne de départ.
endColumn
int
Index de la colonne de fin.
ShowAll()
Affiche toutes les lignes.
public void ShowAll()