Class AutoFilter

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

يمثل الفلترة التلقائية للورقة المحددة.

public class AutoFilter

الوراثة

object ← AutoFilter

الأعضاء الموروثة

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

أمثلة

//إنشاء دفق ملف يحتوي على ملف Excel الذي سيتم فتحه
//إنشاء كائن Workbook
Workbook workbook = new Workbook("template.xlsx");
//الوصول إلى الورقة الأولى في ملف Excel
Worksheet worksheet = workbook.Worksheets[0];
//إنشاء AutoFilter من خلال إعطاء نطاق الخلايا لصف العنوان
worksheet.AutoFilter.Range = "A1:B1";
//تصفية الأعمدة بالقيم المحددة
worksheet.AutoFilter.Filter(1, "Bananas");
//حفظ ملف Excel المعدل.
workbook.Save("output.xls");

'إنشاء دفق ملف يحتوي على ملف Excel الذي سيتم فتحه
'إنشاء كائن Workbook
Dim workbook As Workbook = New Workbook("template.xlsx")
'الوصول إلى الورقة الأولى في ملف Excel
Dim worksheet As Worksheet = workbook.Worksheets(0)
'إنشاء AutoFilter من خلال إعطاء نطاق الخلايا لصف العنوان
worksheet.AutoFilter.Range = "A1:B1"
'تصفية الأعمدة بالقيم المحددة
Worksheet.AutoFilter.Filter(1, "Bananas")
'حفظ ملف Excel المعدل 
workbook.Save("output.xls")

الخصائص

FilterColumns

يحصل على مجموعة أعمدة الفلتر.

public FilterColumnCollection FilterColumns { get; }

قيمة الخاصية

FilterColumnCollection

Range

يمثل النطاق الذي ينطبق عليه الفلتر التلقائي المحدد.

public string Range { get; set; }

قيمة الخاصية

string

ShowFilterButton

تشير إلى ما إذا كانت زر الفلتر لهذا العمود مرئية.

public bool ShowFilterButton { get; set; }

قيمة الخاصية

bool

Sorter

يحصل على فرز البيانات.

public DataSorter Sorter { get; }

قيمة الخاصية

DataSorter

الطرق

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 هو السنة، فإن المعلمة السنة فقط تؤثر. إذا كان DateTimeGroupingType هو الشهر، فإن المعلمات السنة والشهر فقط تؤثر.

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)

تصف قائمة العناصر العشرة الأولى في القائمة

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()

الإرجاع

CellArea

المنطقة التي ينطبق عليها هذا الفلتر

GetCellArea(bool)

يحصل على Aspose.Cells.CellArea حيث ينطبق الفلتر التلقائي المحدد.

public CellArea GetCellArea(bool refreshAppliedRange)

المعلمات

refreshAppliedRange bool

ما إذا كان يجب تحديث النطاق المطبق. بالنسبة لنطاق الفلتر التلقائي، قد يتغير الصف الأخير عندما تتغير بيانات الخلايا. إذا كانت هذه العلامة صحيحة، فسيتم إعادة حساب الصف الأخير من النطاق وفقًا لبيانات الخلايا الحالية.

الإرجاع

CellArea

المنطقة التي ينطبق عليها هذا الفلتر

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

إذا كانت صحيحة، قم بإخفاء الصفوف المفلترة.

الإرجاع

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 هو السنة، فإن المعلمة السنة فقط تؤثر. إذا كان DateTimeGroupingType هو الشهر، فإن المعلمات السنة والشهر فقط تؤثر.

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()