Class AutoFilter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Reprezentuje autofiltrowanie dla określonego arkusza kalkulacyjnego.
public class AutoFilter
Dziedziczenie
Członkowie dziedziczeni
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Przykłady
//Tworzenie strumienia pliku zawierającego plik Excel do otwarcia
//Inicjalizacja obiektu Workbook
Workbook workbook = new Workbook("template.xlsx");
//Dostęp do pierwszego arkusza kalkulacyjnego w pliku Excel
Worksheet worksheet = workbook.Worksheets[0];
//Tworzenie AutoFilter poprzez podanie zakresu komórek wiersza nagłówka
worksheet.AutoFilter.Range = "A1:B1";
//Filtrowanie kolumn z określonymi wartościami
worksheet.AutoFilter.Filter(1, "Banany");
//Zapisanie zmodyfikowanego pliku Excel.
workbook.Save("output.xls");
'Tworzenie strumienia pliku zawierającego plik Excel do otwarcia
'Inicjalizacja obiektu Workbook
Dim workbook As Workbook = New Workbook("template.xlsx")
'Dostęp do pierwszego arkusza kalkulacyjnego w pliku Excel
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Tworzenie AutoFilter poprzez podanie zakresu komórek wiersza nagłówka
worksheet.AutoFilter.Range = "A1:B1"
'Filtrowanie kolumn z określonymi wartościami
Worksheet.AutoFilter.Filter(1, "Banany")
'Zapisanie zmodyfikowanego pliku Excel
workbook.Save("output.xls")
Właściwości
FilterColumns
Zwraca kolekcję kolumn filtrujących.
public FilterColumnCollection FilterColumns { get; }
Wartość właściwości
Range
Reprezentuje zakres, do którego stosuje się określony AutoFilter.
public string Range { get; set; }
Wartość właściwości
ShowFilterButton
Wskazuje, czy przycisk AutoFilter dla tej kolumny jest widoczny.
public bool ShowFilterButton { get; set; }
Wartość właściwości
Sorter
Zwraca sorter danych.
public DataSorter Sorter { get; }
Wartość właściwości
Metody
AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Dodaje filtr daty.
public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
dateTimeGroupingType
DateTimeGroupingType
Typ grupowania
year
int
Rok.
month
int
Miesiąc.
day
int
Dzień.
hour
int
Godzina.
minute
int
Minuta.
second
int
Sekunda.
Uwagi
Jeśli DateTimeGroupingType to Rok, tylko parametr rok ma wpływ. Jeśli DateTimeGroupingType to Miesiąc, tylko parametry rok i miesiąc mają wpływ.
AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)
Dodaje filtr koloru wypełnienia.
public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
pattern
BackgroundType
Typ wzoru tła.
foregroundColor
CellsColor
Kolor pierwszego planu.
backgroundColor
CellsColor
Kolor tła.
AddFilter(int, string)
Dodaje filtr dla kolumny filtra.
public void AddFilter(int fieldIndex, string criteria)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
criteria
string
Określone kryteria (ciąg; na przykład “101”). Może być tylko null lub jedną z wartości komórek w tej kolumnie.
Uwagi
MS Excel 2007 obsługuje wiele wyborów w kolumnie filtra.
AddFontColorFilter(int, CellsColor)
Dodaje filtr koloru czcionki.
public void AddFontColorFilter(int fieldIndex, CellsColor color)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
color
CellsColor
Obiekt Aspose.Cells.CellsColor.
AddIconFilter(int, IconSetType, int)
Dodaje filtr ikony.
public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
iconSetType
IconSetType
Typ zestawu ikon.
iconId
int
Identyfikator ikony.
Uwagi
Obsługuje tylko dodawanie filtra ikony. Nie obsługuje sprawdzania, który wiersz jest widoczny, jeśli filtr to filtr ikony.
Custom(int, FilterOperatorType, object)
Filtruje listę za pomocą niestandardowego kryterium.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
operatorType1
FilterOperatorType
Typ operatora filtra
criteria1
object
Niestandardowe kryteria
Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)
Filtruje listę za pomocą niestandardowych kryteriów.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
operatorType1
FilterOperatorType
Typ operatora filtra
criteria1
object
Niestandardowe kryteria
isAnd
bool
operatorType2
FilterOperatorType
Typ operatora filtra
criteria2
object
Niestandardowe kryteria
DynamicFilter(int, DynamicFilterType)
Dodaje dynamiczny filtr.
public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
dynamicFilterType
DynamicFilterType
Typ dynamicznego filtra.
Filter(int, string)
Filtruje listę za pomocą określonych kryteriów.
public void Filter(int fieldIndex, string criteria)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
criteria
string
Określone kryteria (ciąg; na przykład “101”).
Uwagi
Aspose.Cells usunie wszystkie inne ustawienia filtra na tym polu, jak w Ms Excel 97-2003.
FilterTop10(int, bool, bool, int)
Filtruje 10 najlepszych elementów na liście
public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
isTop
bool
Wskazuje, czy filtrować od góry czy od dołu
isPercent
bool
Wskazuje, czy elementy to procenty czy liczby
itemCount
int
Liczba elementów
GetCellArea()
Zwraca Aspose.Cells.CellArea, do którego stosuje się ten AutoFilter.
public CellArea GetCellArea()
Zwraca
obszar, do którego stosuje się ten filtr
GetCellArea(bool)
Zwraca Aspose.Cells.CellArea, do którego stosuje się określony AutoFilter.
public CellArea GetCellArea(bool refreshAppliedRange)
Parametry
refreshAppliedRange
bool
Czy odświeżyć zastosowany zakres. Dla zastosowanego zakresu autofiltrowania ostatni wiersz może się zmienić, gdy dane w komórkach się zmieniają. Jeśli ten flag jest prawdziwy, ostatni wiersz zakresu zostanie ponownie obliczony zgodnie z aktualnymi danymi w komórkach.
Zwraca
obszar, do którego stosuje się ten filtr
MatchBlanks(int)
Dopasowuje wszystkie puste komórki na liście.
public void MatchBlanks(int fieldIndex)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
MatchNonBlanks(int)
Dopasowuje wszystkie niepuste komórki na liście.
public void MatchNonBlanks(int fieldIndex)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
Refresh()
Odświeża autofiltrowania, aby ukryć lub odkryć wiersze.
public int[] Refresh()
Zwraca
int[]
Zwraca indeksy wszystkich ukrytych wierszy.
Refresh(bool)
Zwraca indeksy wszystkich ukrytych wierszy.
public int[] Refresh(bool hideRows)
Parametry
hideRows
bool
Jeśli prawda, ukryj przefiltrowane wiersze.
Zwraca
int[]
Zwraca indeksy wszystkich ukrytych wierszy.
RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
Usuwa filtr daty.
public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
dateTimeGroupingType
DateTimeGroupingType
Typ grupowania
year
int
Rok.
month
int
Miesiąc.
day
int
Dzień.
hour
int
Godzina.
minute
int
Minuta.
second
int
Sekunda.
Uwagi
Jeśli DateTimeGroupingType to Rok, tylko parametr rok ma wpływ. Jeśli DateTimeGroupingType to Miesiąc, tylko parametry rok i miesiąc mają wpływ.
RemoveFilter(int, string)
Usuwa filtr dla kolumny filtra.
public void RemoveFilter(int fieldIndex, string criteria)
Parametry
fieldIndex
int
Całkowity offset pola, na którym chcesz oprzeć filtr (licząc od lewej listy; najbardziej lewostronne pole to pole 0).
criteria
string
Określone kryteria (ciąg; na przykład “101”). Może być tylko null lub jedną z wartości komórek w tej kolumnie.
RemoveFilter(int)
Usuwa konkretny filtr.
public void RemoveFilter(int fieldIndex)
Parametry
fieldIndex
int
Indeks konkretnego filtra
SetRange(int, int, int)
Ustawia zakres, do którego stosuje się określony AutoFilter.
public void SetRange(int row, int startColumn, int endColumn)
Parametry
row
int
Indeks wiersza.
startColumn
int
Indeks kolumny początkowej.
endColumn
int
Indeks kolumny końcowej.
ShowAll()
Odkrywa wszystkie wiersze.
public void ShowAll()