Class AutoFilter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Stellt die Autofilterung für das angegebene Arbeitsblatt dar.
public class AutoFilter
Vererbung
Vererbte Mitglieder
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Beispiele
//Erstellen eines Dateistreams, der die zu öffnende Excel-Datei enthält
//Instanziieren eines Workbook-Objekts
Workbook workbook = new Workbook("template.xlsx");
//Zugriff auf das erste Arbeitsblatt in der Excel-Datei
Worksheet worksheet = workbook.Worksheets[0];
//Erstellen des AutoFilters, indem der Zellbereich der Überschriftenzeile angegeben wird
worksheet.AutoFilter.Range = "A1:B1";
//Filtern der Spalten mit angegebenen Werten
worksheet.AutoFilter.Filter(1, "Bananen");
//Speichern der modifizierten Excel-Datei.
workbook.Save("output.xls");
'Erstellen eines Dateistreams, der die zu öffnende Excel-Datei enthält
'Instanziieren eines Workbook-Objekts
Dim workbook As Workbook = New Workbook("template.xlsx")
'Zugriff auf das erste Arbeitsblatt in der Excel-Datei
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Erstellen des AutoFilters, indem der Zellbereich der Überschriftenzeile angegeben wird
worksheet.AutoFilter.Range = "A1:B1"
'Filtern der Spalten mit angegebenen Werten
Worksheet.AutoFilter.Filter(1, "Bananen")
'Speichern der modifizierten Excel-Datei
workbook.Save("output.xls")
Eigenschaften
FilterColumns
Erhält die Sammlung der Filterspalten.
public FilterColumnCollection FilterColumns { get; }
Eigenschaftswert
Range
Stellt den Bereich dar, auf den der angegebene AutoFilter angewendet wird.
public string Range { get; set; }
Eigenschaftswert
ShowFilterButton
Gibt an, ob der AutoFilter-Button für diese Spalte sichtbar ist.
public bool ShowFilterButton { get; set; }
Eigenschaftswert
Sorter
Erhält den Datensortierer.
public DataSorter Sorter { get; }
Eigenschaftswert
Methoden
AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Fügt einen Datumsfilter hinzu.
public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
dateTimeGroupingType
DateTimeGroupingType
Der Gruppierungstyp
year
int
Das Jahr.
month
int
Der Monat.
day
int
Der Tag.
hour
int
Die Stunde.
minute
int
Die Minute.
second
int
Die Sekunde.
Bemerkungen
Wenn DateTimeGroupingType Jahr ist, hat nur der Parameter Jahr Wirkung. Wenn DateTimeGroupingType Monat ist, haben nur die Parameter Jahr und Monat Wirkung.
AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)
Fügt einen Füllfarbfilter hinzu.
public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
pattern
BackgroundType
Der Hintergrundmuster-Typ.
foregroundColor
CellsColor
Die Vordergrundfarbe.
backgroundColor
CellsColor
Die Hintergrundfarbe.
AddFilter(int, string)
Fügt einen Filter für eine Filterspalte hinzu.
public void AddFilter(int fieldIndex, string criteria)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
criteria
string
Die angegebenen Kriterien (ein String; z. B. “101”). Es kann nur null sein oder einer der Zellwerte in dieser Spalte.
Bemerkungen
MS Excel 2007 unterstützt die Mehrfachauswahl in einer Filterspalte.
AddFontColorFilter(int, CellsColor)
Fügt einen Schriftfarbenfilter hinzu.
public void AddFontColorFilter(int fieldIndex, CellsColor color)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
color
CellsColor
Das Aspose.Cells.CellsColor-Objekt.
AddIconFilter(int, IconSetType, int)
Fügt einen Iconfilter hinzu.
public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
iconSetType
IconSetType
Der Iconset-Typ.
iconId
int
Die Icon-ID.
Bemerkungen
Unterstützt nur das Hinzufügen des Iconfilters. Unterstützt nicht die Überprüfung, welche Zeile sichtbar ist, wenn der Filter ein Iconfilter ist.
Custom(int, FilterOperatorType, object)
Filtert eine Liste mit benutzerdefinierten Kriterien.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
operatorType1
FilterOperatorType
Der Filteroperator-Typ
criteria1
object
Die benutzerdefinierten Kriterien
Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)
Filtert eine Liste mit benutzerdefinierten Kriterien.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
operatorType1
FilterOperatorType
Der Filteroperator-Typ
criteria1
object
Die benutzerdefinierten Kriterien
isAnd
bool
operatorType2
FilterOperatorType
Der Filteroperator-Typ
criteria2
object
Die benutzerdefinierten Kriterien
DynamicFilter(int, DynamicFilterType)
Fügt einen dynamischen Filter hinzu.
public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
dynamicFilterType
DynamicFilterType
Dynamischer Filtertyp.
Filter(int, string)
Filtert eine Liste mit angegebenen Kriterien.
public void Filter(int fieldIndex, string criteria)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
criteria
string
Die angegebenen Kriterien (ein String; z. B. “101”).
Bemerkungen
Aspose.Cells entfernt alle anderen Filtereinstellungen in diesem Feld wie Ms Excel 97-2003.
FilterTop10(int, bool, bool, int)
Filtert die obersten 10 Elemente in der Liste
public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
isTop
bool
Gibt an, ob von oben oder unten gefiltert werden soll
isPercent
bool
Gibt an, ob die Elemente Prozent oder Anzahl sind
itemCount
int
Die Anzahl der Elemente
GetCellArea()
Erhält die Aspose.Cells.CellArea, auf die dieser AutoFilter angewendet wird.
public CellArea GetCellArea()
Gibt zurück
der Bereich, auf den dieser Filter angewendet wird
GetCellArea(bool)
Erhält die Aspose.Cells.CellArea, auf die der angegebene AutoFilter angewendet wird.
public CellArea GetCellArea(bool refreshAppliedRange)
Parameter
refreshAppliedRange
bool
Ob der angewendete Bereich aktualisiert werden soll. Für den angewendeten Bereich des AutoFilters kann sich die letzte Zeile ändern, wenn sich die Zellendaten ändern. Wenn dieses Flag wahr ist, wird die letzte Zeile des Bereichs gemäß den aktuellen Zellendaten neu berechnet.
Gibt zurück
der Bereich, auf den dieser Filter angewendet wird
MatchBlanks(int)
Übereinstimmung aller leeren Zellen in der Liste.
public void MatchBlanks(int fieldIndex)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
MatchNonBlanks(int)
Übereinstimmung aller nicht leeren Zellen in der Liste.
public void MatchNonBlanks(int fieldIndex)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
Refresh()
Aktualisiert die AutoFilter, um die Zeilen auszublenden oder anzuzeigen.
public int[] Refresh()
Gibt zurück
int[]
Gibt alle Indizes der ausgeblendeten Zeilen zurück.
Refresh(bool)
Erhält alle Indizes der ausgeblendeten Zeilen.
public int[] Refresh(bool hideRows)
Parameter
hideRows
bool
Wenn wahr, blenden Sie die gefilterten Zeilen aus.
Gibt zurück
int[]
Gibt alle Indizes der ausgeblendeten Zeilen zurück.
RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Entfernt einen Datumsfilter.
public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
dateTimeGroupingType
DateTimeGroupingType
Der Gruppierungstyp
year
int
Das Jahr.
month
int
Der Monat.
day
int
Der Tag.
hour
int
Die Stunde.
minute
int
Die Minute.
second
int
Die Sekunde.
Bemerkungen
Wenn DateTimeGroupingType Jahr ist, hat nur der Parameter Jahr Wirkung. Wenn DateTimeGroupingType Monat ist, haben nur die Parameter Jahr und Monat Wirkung.
RemoveFilter(int, string)
Entfernt einen Filter für eine Filterspalte.
public void RemoveFilter(int fieldIndex, string criteria)
Parameter
fieldIndex
int
Der ganzzahlige Offset des Feldes, auf dem Sie den Filter basieren möchten (von links in der Liste; das linkeste Feld ist Feld 0).
criteria
string
Die angegebenen Kriterien (ein String; z. B. “101”). Es kann nur null sein oder einer der Zellwerte in dieser Spalte sein.
RemoveFilter(int)
Entfernt den spezifischen Filter.
public void RemoveFilter(int fieldIndex)
Parameter
fieldIndex
int
Der spezifische Filterindex
SetRange(int, int, int)
Legt den Bereich fest, auf den der angegebene AutoFilter angewendet wird.
public void SetRange(int row, int startColumn, int endColumn)
Parameter
row
int
Zeilenindex.
startColumn
int
Startspaltenindex.
endColumn
int
Endspaltenindex.
ShowAll()
Blendet alle Zeilen ein.
public void ShowAll()