Class AutoFilter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Rappresenta il filtro automatico per il foglio di lavoro specificato.
public class AutoFilter
Ereditarietà
Membri Ereditati
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Esempi
//Creazione di uno stream di file contenente il file Excel da aprire
//Istanziazione di un oggetto Workbook
Workbook workbook = new Workbook("template.xlsx");
//Accesso al primo foglio di lavoro nel file Excel
Worksheet worksheet = workbook.Worksheets[0];
//Creazione di AutoFilter fornendo l'intervallo delle celle della riga di intestazione
worksheet.AutoFilter.Range = "A1:B1";
//Filtraggio delle colonne con valori specificati
worksheet.AutoFilter.Filter(1, "Banane");
//Salvataggio del file Excel modificato.
workbook.Save("output.xls");
'Creazione di uno stream di file contenente il file Excel da aprire
'Istanziazione di un oggetto Workbook
Dim workbook As Workbook = New Workbook("template.xlsx")
'Accesso al primo foglio di lavoro nel file Excel
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Creazione di AutoFilter fornendo l'intervallo delle celle della riga di intestazione
worksheet.AutoFilter.Range = "A1:B1"
'Filtraggio delle colonne con valori specificati
Worksheet.AutoFilter.Filter(1, "Banane")
'Salvataggio del file Excel modificato
workbook.Save("output.xls")
Proprietà
FilterColumns
Ottiene la collezione delle colonne di filtro.
public FilterColumnCollection FilterColumns { get; }
Valore della Proprietà
Range
Rappresenta l’intervallo a cui si applica il filtro automatico specificato.
public string Range { get; set; }
Valore della Proprietà
ShowFilterButton
Indica se il pulsante di filtro automatico per questa colonna è visibile.
public bool ShowFilterButton { get; set; }
Valore della Proprietà
Sorter
Ottiene il ordinatore dei dati.
public DataSorter Sorter { get; }
Valore della Proprietà
Metodi
AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Aggiunge un filtro di data.
public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
dateTimeGroupingType
DateTimeGroupingType
Il tipo di raggruppamento
year
int
L’anno.
month
int
Il mese.
day
int
Il giorno.
hour
int
L’ora.
minute
int
Il minuto.
second
int
Il secondo.
Osservazioni
Se DateTimeGroupingType è Year, solo il parametro year ha effetto. Se DateTimeGroupingType è Month, solo i parametri year e month hanno effetto.
AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)
Aggiunge un filtro di colore di riempimento.
public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
pattern
BackgroundType
Il tipo di modello di sfondo.
foregroundColor
CellsColor
Il colore di primo piano.
backgroundColor
CellsColor
Il colore di sfondo.
AddFilter(int, string)
Aggiunge un filtro per una colonna di filtro.
public void AddFilter(int fieldIndex, string criteria)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
criteria
string
I criteri specificati (una stringa; ad esempio, “101”). Può essere solo null o uno dei valori delle celle in questa colonna.
Osservazioni
MS Excel 2007 supporta la selezione multipla in una colonna di filtro.
AddFontColorFilter(int, CellsColor)
Aggiunge un filtro di colore del carattere.
public void AddFontColorFilter(int fieldIndex, CellsColor color)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
color
CellsColor
L’oggetto Aspose.Cells.CellsColor.
AddIconFilter(int, IconSetType, int)
Aggiunge un filtro di icona.
public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
iconSetType
IconSetType
Il tipo di set di icone.
iconId
int
L’ID dell’icona.
Osservazioni
Supporta solo l’aggiunta del filtro icona. Non supporta il controllo di quale riga è visibile se il filtro è un filtro icona.
Custom(int, FilterOperatorType, object)
Filtra un elenco con criteri personalizzati.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
operatorType1
FilterOperatorType
Il tipo di operatore di filtro
criteria1
object
I criteri personalizzati
Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)
Filtra un elenco con criteri personalizzati.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
operatorType1
FilterOperatorType
Il tipo di operatore di filtro
criteria1
object
I criteri personalizzati
isAnd
bool
operatorType2
FilterOperatorType
Il tipo di operatore di filtro
criteria2
object
I criteri personalizzati
DynamicFilter(int, DynamicFilterType)
Aggiunge un filtro dinamico.
public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
dynamicFilterType
DynamicFilterType
Tipo di filtro dinamico.
Filter(int, string)
Filtra un elenco con criteri specificati.
public void Filter(int fieldIndex, string criteria)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
criteria
string
I criteri specificati (una stringa; ad esempio, “101”).
Osservazioni
Aspose.Cells rimuoverà tutte le altre impostazioni di filtro su questo campo come Ms Excel 97-2003.
FilterTop10(int, bool, bool, int)
Filtra i primi 10 elementi nell’elenco
public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
isTop
bool
Indica se filtrare dall’alto o dal basso
isPercent
bool
Indica se gli elementi sono percentuali o conteggio
itemCount
int
Il conteggio degli elementi
GetCellArea()
Ottiene l’Aspose.Cells.CellArea a cui si applica questo filtro automatico.
public CellArea GetCellArea()
Restituisce
l’area a cui si applica questo filtro
GetCellArea(bool)
Ottiene l’Aspose.Cells.CellArea a cui si applica il filtro automatico specificato.
public CellArea GetCellArea(bool refreshAppliedRange)
Parametri
refreshAppliedRange
bool
Se aggiornare l’intervallo applicato. Per l’intervallo applicato del filtro automatico, l’ultima riga può cambiare quando i dati delle celle cambiano. Se questo flag è vero, l’ultima riga dell’intervallo verrà ricalcolata in base ai dati attuali delle celle.
Restituisce
l’area a cui si applica questo filtro
MatchBlanks(int)
Corrisponde a tutte le celle vuote nell’elenco.
public void MatchBlanks(int fieldIndex)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
MatchNonBlanks(int)
Corrisponde a tutte le celle non vuote nell’elenco.
public void MatchNonBlanks(int fieldIndex)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
Refresh()
Aggiorna i filtri automatici per nascondere o mostrare le righe.
public int[] Refresh()
Restituisce
int[]
Restituisce tutti gli indici delle righe nascoste.
Refresh(bool)
Ottiene tutti gli indici delle righe nascoste.
public int[] Refresh(bool hideRows)
Parametri
hideRows
bool
Se vero, nasconde le righe filtrate.
Restituisce
int[]
Restituisce tutti gli indici delle righe nascoste.
RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Rimuove un filtro di data.
public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
dateTimeGroupingType
DateTimeGroupingType
Il tipo di raggruppamento
year
int
L’anno.
month
int
Il mese.
day
int
Il giorno.
hour
int
L’ora.
minute
int
Il minuto.
second
int
Il secondo.
Osservazioni
Se DateTimeGroupingType è Year, solo il parametro year ha effetto. Se DateTimeGroupingType è Month, solo i parametri year e month hanno effetto.
RemoveFilter(int, string)
Rimuove un filtro per una colonna di filtro.
public void RemoveFilter(int fieldIndex, string criteria)
Parametri
fieldIndex
int
L’offset intero del campo su cui si desidera basare il filtro (da sinistra nella lista; il campo più a sinistra è il campo 0).
criteria
string
I criteri specificati (una stringa; ad esempio, “101”). Può essere solo null o uno dei valori delle celle in questa colonna.
RemoveFilter(int)
Rimuove il filtro specifico.
public void RemoveFilter(int fieldIndex)
Parametri
fieldIndex
int
L’indice del filtro specifico
SetRange(int, int, int)
Imposta l’intervallo a cui si applica il filtro automatico specificato.
public void SetRange(int row, int startColumn, int endColumn)
Parametri
row
int
Indice della riga.
startColumn
int
Indice della colonna di inizio.
endColumn
int
Indice della colonna di fine.
ShowAll()
Mostra tutte le righe.
public void ShowAll()