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; }

ค่า Property

FilterColumnCollection

Range

แทนที่ช่วงที่ AutoFilter ที่ระบุใช้

public string Range { get; set; }

ค่า Property

string

ShowFilterButton

ระบุว่า AutoFilter ปุ่มสำหรับคอลัมน์นี้มองเห็นได้หรือไม่

public bool ShowFilterButton { get; set; }

ค่า Property

bool

Sorter

รับตัวจัดเรียงข้อมูล

public DataSorter Sorter { get; }

ค่า Property

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

ระบุว่าควรรีเฟรชช่วงที่ใช้หรือไม่ สำหรับช่วงที่ใช้ของตัวกรองอัตโนมัติ แถวสุดท้ายอาจเปลี่ยนเมื่อข้อมูลเซลล์เปลี่ยน หากธงนี้เป็นจริง แถวสุดท้ายของช่วงจะถูกคำนวณใหม่ตามข้อมูลเซลล์ปัจจุบัน

คืนค่า

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)

ตั้งค่าช่วงที่ AutoFilter ที่ระบุใช้

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

พารามิเตอร์

row int

ดัชนีแถว

startColumn int

ดัชนีคอลัมน์เริ่มต้น

endColumn int

ดัชนีคอลัมน์สิ้นสุด

ShowAll()

แสดงแถวทั้งหมด

public void ShowAll()