Class AutoFilter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
מייצג סינון אוטומטי עבור גיליון העבודה המוגדר.
public class AutoFilter
ירושה
חברים ירושים
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
דוגמאות
//יצירת זרם קובץ המכיל את קובץ האקסל שייפתח
//אינסטנציית אובייקט Workbook
Workbook workbook = new Workbook("template.xlsx");
//גישה לגיליון העבודה הראשון בקובץ האקסל
Worksheet worksheet = workbook.Worksheets[0];
//יצירת AutoFilter על ידי מתן טווח התאים של שורת הכותרת
worksheet.AutoFilter.Range = "A1:B1";
//סינון עמודות עם ערכים מוגדרים
worksheet.AutoFilter.Filter(1, "Bananas");
//שמור את קובץ האקסל המושנה.
workbook.Save("output.xls");
'יצירת זרם קובץ המכיל את קובץ האקסל שייפתח
'אינסטנציית אובייקט Workbook
Dim workbook As Workbook = New Workbook("template.xlsx")
'גישה לגיליון העבודה הראשון בקובץ האקסל
Dim worksheet As Worksheet = workbook.Worksheets(0)
'יצירת AutoFilter על ידי מתן טווח התאים של שורת הכותרת
worksheet.AutoFilter.Range = "A1:B1"
'סינון עמודות עם ערכים מוגדרים
Worksheet.AutoFilter.Filter(1, "Bananas")
'שמור את קובץ האקסל המושנה
workbook.Save("output.xls")
תכונות
FilterColumns
מקבל את האוסף של עמודות הסינון.
public FilterColumnCollection FilterColumns { get; }
ערך תכונה
Range
מייצג את הטווח שעליו הסינון האוטומטי המוגדר חל.
public string Range { get; set; }
ערך תכונה
ShowFilterButton
מציין אם כפתור הסינון עבור עמודה זו גלוי.
public bool ShowFilterButton { get; set; }
ערך תכונה
Sorter
מקבל את מסנן הנתונים.
public DataSorter Sorter { get; }
ערך תכונה
שיטות
AddDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
מוסיף סינון תאריך.
public void AddDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
dateTimeGroupingType
DateTimeGroupingType
סוג הקיבוץ
year
int
השנה.
month
int
החודש.
day
int
היום.
hour
int
השעה.
minute
int
הדקה.
second
int
השנייה.
הערות
אם DateTimeGroupingType הוא שנה, רק הפרמטר שנה משפיע. אם DateTiemGroupingType הוא חודש, רק הפרמטרים שנה וחודש משפיעים.
AddFillColorFilter(int, BackgroundType, CellsColor, CellsColor)
מוסיף סינון צבע מילוי.
public void AddFillColorFilter(int fieldIndex, BackgroundType pattern, CellsColor foregroundColor, CellsColor backgroundColor)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
pattern
BackgroundType
סוג תבנית הרקע.
foregroundColor
CellsColor
הצבע הקדמי.
backgroundColor
CellsColor
צבע הרקע.
AddFilter(int, string)
מוסיף סינון עבור עמודת סינון.
public void AddFilter(int fieldIndex, string criteria)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
criteria
string
הקריטריון המוגדר (מחרוזת; לדוגמה, “101”). זה יכול להיות null או אחד מערכי התאים בעמודה זו.
הערות
MS Excel 2007 תומך בבחירה מרובה בעמודת סינון.
AddFontColorFilter(int, CellsColor)
מוסיף סינון צבע גופן.
public void AddFontColorFilter(int fieldIndex, CellsColor color)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
color
CellsColor
אובייקט Aspose.Cells.CellsColor.
AddIconFilter(int, IconSetType, int)
מוסיף סינון אייקון.
public void AddIconFilter(int fieldIndex, IconSetType iconSetType, int iconId)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
iconSetType
IconSetType
סוג סט האייקונים.
iconId
int
הזיהוי של האייקון.
הערות
תומך רק בהוספת סינון אייקון. לא תומך בבדיקת איזו שורה גלויה אם הסינון הוא סינון אייקון.
Custom(int, FilterOperatorType, object)
מסנן רשימה עם קריטריון מותאם אישית.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
operatorType1
FilterOperatorType
סוג מפעיל הסינון
criteria1
object
הקריטריון המותאם אישית
Custom(int, FilterOperatorType, object, bool, FilterOperatorType, object)
מסנן רשימה עם קריטריונים מותאמים אישית.
public void Custom(int fieldIndex, FilterOperatorType operatorType1, object criteria1, bool isAnd, FilterOperatorType operatorType2, object criteria2)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
operatorType1
FilterOperatorType
סוג מפעיל הסינון
criteria1
object
הקריטריון המותאם אישית
isAnd
bool
operatorType2
FilterOperatorType
סוג מפעיל הסינון
criteria2
object
הקריטריון המותאם אישית
DynamicFilter(int, DynamicFilterType)
מוסיף סינון דינמי.
public void DynamicFilter(int fieldIndex, DynamicFilterType dynamicFilterType)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
dynamicFilterType
DynamicFilterType
סוג הסינון הדינמי.
Filter(int, string)
מסנן רשימה עם קריטריונים מוגדרים.
public void Filter(int fieldIndex, string criteria)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
criteria
string
הקריטריון המוגדר (מחרוזת; לדוגמה, “101”).
הערות
Aspose.Cells יסיר את כל הגדרות הסינון האחרות בשדה זה כמו ב-Ms Excel 97-2003.
FilterTop10(int, bool, bool, int)
מסנן את 10 הפריטים העליונים ברשימה
public void FilterTop10(int fieldIndex, bool isTop, bool isPercent, int itemCount)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
isTop
bool
מציין אם הסינון מהחלק העליון או התחתון
isPercent
bool
מציין אם הפריטים הם אחוזים או ספירה
itemCount
int
מספר הפריטים
GetCellArea()
מקבל את Aspose.Cells.CellArea שבו הסינון האוטומטי הזה חל.
public CellArea GetCellArea()
מחזיר
האזור שבו הסינון הזה חל
GetCellArea(bool)
מקבל את Aspose.Cells.CellArea שבו הסינון האוטומטי המוגדר חל.
public CellArea GetCellArea(bool refreshAppliedRange)
פרמטרים
refreshAppliedRange
bool
אם לרענן את הטווח המופעל. עבור הטווח המופעל של הסינון האוטומטי, השורה האחרונה עשויה להשתנות כאשר נתוני התאים משתנים. אם דגל זה הוא true, אז השורה האחרונה של הטווח תיחשב מחדש בהתאם לנתוני התאים הנוכחיים.
מחזיר
האזור שבו הסינון הזה חל
MatchBlanks(int)
מתאים לכל תא ריק ברשימה.
public void MatchBlanks(int fieldIndex)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
MatchNonBlanks(int)
מתאים לכל תא שאינו ריק ברשימה.
public void MatchNonBlanks(int fieldIndex)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
Refresh()
מרענן את הסינונים האוטומטיים כדי להסתיר או לחשוף את השורות.
public int[] Refresh()
מחזיר
int[]
מחזיר את כל האינדקסים של השורות המוסתרות.
Refresh(bool)
מקבל את כל האינדקסים של השורות המוסתרות.
public int[] Refresh(bool hideRows)
פרמטרים
hideRows
bool
אם true, הסתר את השורות המסוננות.
מחזיר
int[]
מחזיר את כל האינדקסים של השורות המוסתרות.
RemoveDateFilter(int, DateTimeGroupingType, int, int, int, int, int, int)
מסיר סינון תאריך.
public void RemoveDateFilter(int fieldIndex, DateTimeGroupingType dateTimeGroupingType, int year, int month, int day, int hour, int minute, int second)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
dateTimeGroupingType
DateTimeGroupingType
סוג הקיבוץ
year
int
השנה.
month
int
החודש.
day
int
היום.
hour
int
השעה.
minute
int
הדקה.
second
int
השנייה.
הערות
אם DateTimeGroupingType הוא שנה, רק הפרמטר שנה משפיע. אם DateTiemGroupingType הוא חודש, רק הפרמטרים שנה וחודש משפיעים.
RemoveFilter(int, string)
מסיר סינון עבור עמודת סינון.
public void RemoveFilter(int fieldIndex, string criteria)
פרמטרים
fieldIndex
int
ההסטה של השדה שעליו אתה רוצה לבסס את הסינון (מהצד השמאלי של הרשימה; השדה השמאלי ביותר הוא שדה 0).
criteria
string
הקריטריון המוגדר (מחרוזת; לדוגמה, “101”). זה יכול להיות null או אחד מערכי התאים בעמודה זו.
RemoveFilter(int)
מסיר את הסינון הספציפי.
public void RemoveFilter(int fieldIndex)
פרמטרים
fieldIndex
int
אינדקס הסינון הספציפי
SetRange(int, int, int)
מגדיר את הטווח שעליו הסינון האוטומטי המוגדר חל.
public void SetRange(int row, int startColumn, int endColumn)
פרמטרים
row
int
אינדקס השורה.
startColumn
int
אינדקס עמודת ההתחלה.
endColumn
int
אינדקס עמודת הסיום.
ShowAll()
מגלה את כל השורות.
public void ShowAll()