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

مثال‌ها

//ایجاد یک جریان فایل حاوی فایل اکسل که باید باز شود
//ایجاد یک شی 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; }

مقدار ویژگی

FilterColumnCollection

Range

محدوده‌ای را که AutoFilter مشخص شده به آن اعمال می‌شود، نمایندگی می‌کند.

public string Range { get; set; }

مقدار ویژگی

string

ShowFilterButton

نشان می‌دهد که آیا دکمه AutoFilter برای این ستون قابل مشاهده است یا خیر.

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)

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 را به دست می‌آورد که این AutoFilter به آن اعمال می‌شود.

public CellArea GetCellArea()

بازگشت

CellArea

منطقه‌ای که این فیلتر به آن اعمال می‌شود

GetCellArea(bool)

Aspose.Cells.CellArea را به دست می‌آورد که فیلتر AutoFilter مشخص شده به آن اعمال می‌شود.

public CellArea GetCellArea(bool refreshAppliedRange)

پارامترها

refreshAppliedRange bool

آیا محدوده اعمال شده را تازه‌سازی کند. برای محدوده اعمال شده فیلتر خودکار، آخرین ردیف ممکن است هنگام تغییر داده‌های سلول تغییر کند. اگر این پرچم true باشد، آخرین ردیف محدوده بر اساس داده‌های فعلی سلول‌ها مجدداً محاسبه خواهد شد.

بازگشت

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

اگر 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 سال باشد، تنها پارامتر سال تأثیر می‌گذارد. اگر 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)

محدوده‌ای را که AutoFilter مشخص شده به آن اعمال می‌شود، تنظیم می‌کند.

public void SetRange(int row, int startColumn, int endColumn)

پارامترها

row int

ایندکس ردیف.

startColumn int

ایندکس ستون شروع.

endColumn int

ایندکس ستون پایان.

ShowAll()

تمام ردیف‌ها را نمایان می‌کند.

public void ShowAll()