Class DataSorter
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
คำอธิบายสรุปสำหรับ DataSorter.
public class DataSorter
การสืบทอด
สมาชิกที่สืบทอด
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
ตัวอย่าง
//สร้างอ็อบเจ็กต์ Workbook ใหม่
Workbook workbook = new Workbook("Book1.xls");
//รับอ็อบเจ็กต์ datasorter ของ workbook
DataSorter sorter = workbook.DataSorter;
//ตั้งค่าลำดับแรกสำหรับอ็อบเจ็กต์ datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending;
//กำหนดคีย์แรก
sorter.Key1 = 0;
//ตั้งค่าลำดับที่สองสำหรับอ็อบเจ็กต์ datasorter
sorter.Order2 = Aspose.Cells.SortOrder.Ascending;
//กำหนดคีย์ที่สอง
sorter.Key2 = 1;
//สร้างพื้นที่เซลล์ (ช่วง)
CellArea ca = new CellArea();
//ระบุดัชนแถวเริ่มต้น
ca.StartRow = 0;
//ระบุดัชนคอลัมน์เริ่มต้น
ca.StartColumn = 0;
//ระบุดัชนแถวสุดท้าย
ca.EndRow = 13;
//ระบุดัชนคอลัมน์สุดท้าย
ca.EndColumn = 1;
//จัดเรียงข้อมูลในช่วงข้อมูลที่ระบุ (A1:B14)
sorter.Sort(workbook.Worksheets[0].Cells, ca);
//บันทึกไฟล์ excel
workbook.Save("outBook.xls");
'สร้างอ็อบเจ็กต์ Workbook ใหม่
Dim workbook As Workbook = New Workbook("Book1.xls")
'รับอ็อบเจ็กต์ datasorter ของ workbook
Dim sorter As DataSorter = workbook.DataSorter
'ตั้งค่าลำดับแรกสำหรับอ็อบเจ็กต์ datasorter
sorter.Order1 = Aspose.Cells.SortOrder.Descending
'กำหนดคีย์แรก
sorter.Key1 = 0
'ตั้งค่าลำดับที่สองสำหรับอ็อบเจ็กต์ datasorter
sorter.Order2 = Aspose.Cells.SortOrder.Ascending
'กำหนดคีย์ที่สอง
sorter.Key2 = 1
'สร้างพื้นที่เซลล์ (ช่วง)
Dim ca As CellArea = New CellArea
'ระบุดัชนแถวเริ่มต้น
ca.StartRow = 0
'ระบุดัชนคอลัมน์เริ่มต้น
ca.StartColumn = 0
'ระบุดัชนแถวสุดท้าย
ca.EndRow = 13
'ระบุดัชนคอลัมน์สุดท้าย
ca.EndColumn = 1
'จัดเรียงข้อมูลในช่วงข้อมูลที่ระบุ (A1:B14)
sorter.Sort(workbook.Worksheets(0).Cells, ca)
'บันทึกไฟล์ excel
workbook.Save("outBook.xls")
คุณสมบัติ
CaseSensitive
รับและตั้งค่าให้เป็นการเปรียบเทียบที่มีความไวต่ออักษรตัวพิมพ์ใหญ่
public bool CaseSensitive { get; set; }
ค่าของคุณสมบัติ
HasHeaders
แสดงว่าช่วงมีหัวข้อหรือไม่
public bool HasHeaders { get; set; }
ค่าของคุณสมบัติ
Key1
แสดงดัชนีคอลัมน์ที่จัดเรียงแรก (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
public int Key1 { get; set; }
ค่าของคุณสมบัติ
Key2
แสดงดัชนีคอลัมน์ที่จัดเรียงที่สอง (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
public int Key2 { get; set; }
ค่าของคุณสมบัติ
Key3
แสดงดัชนีคอลัมน์ที่จัดเรียงที่สาม (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
public int Key3 { get; set; }
ค่าของคุณสมบัติ
Keys
รับรายชื่อคีย์ของตัวจัดเรียงข้อมูล
public DataSorterKeyCollection Keys { get; }
ค่าของคุณสมบัติ
Order1
แสดงลำดับการจัดเรียงของคีย์แรก
public SortOrder Order1 { get; set; }
ค่าของคุณสมบัติ
Order2
แสดงลำดับการจัดเรียงของคีย์ที่สอง
public SortOrder Order2 { get; set; }
ค่าของคุณสมบัติ
Order3
แสดงลำดับการจัดเรียงของคีย์ที่สาม
public SortOrder Order3 { get; set; }
ค่าของคุณสมบัติ
SortAsNumber
ระบุว่าจัดเรียงทุกอย่างที่ดูเหมือนเป็นตัวเลขหรือไม่
public bool SortAsNumber { get; set; }
ค่าของคุณสมบัติ
SortLeftToRight
จริงหมายถึงทิศทางการจัดเรียงจากซ้ายไปขวา เท็จหมายถึงทิศทางการจัดเรียงจากบนลงล่าง ค่าดีฟอลต์คือเท็จ
public bool SortLeftToRight { get; set; }
ค่าของคุณสมบัติ
วิธีการ
AddColorKey(int, SortOnType, SortOrder, Color)
เพิ่มคีย์การจัดเรียงสี
public void AddColorKey(int key, SortOnType type, SortOrder order, Color color)
พารามิเตอร์
key
int
ดัชนีคอลัมน์ที่จัดเรียง (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
type
SortOnType
ประเภทค่าของสีที่จัดเรียง
order
SortOrder
ลำดับการจัดเรียง
color
Color
สีที่กำหนดเองสำหรับการจัดเรียง
AddKey(int, SortOrder)
เพิ่มดัชนีคอลัมน์ที่จัดเรียงและลำดับการจัดเรียง
public void AddKey(int key, SortOrder order)
พารามิเตอร์
key
int
ดัชนีคอลัมน์ที่จัดเรียง (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
order
SortOrder
ลำดับการจัดเรียง
AddKey(int, SortOrder, string)
เพิ่มดัชนีคอลัมน์ที่จัดเรียงและลำดับการจัดเรียงพร้อมรายการจัดเรียงที่กำหนดเอง
public void AddKey(int key, SortOrder order, string customList)
พารามิเตอร์
key
int
ดัชนีคอลัมน์ที่จัดเรียง (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
order
SortOrder
ลำดับการจัดเรียง
customList
string
รายการจัดเรียงที่กำหนดเอง
AddKey(int, SortOnType, SortOrder, object)
เพิ่มดัชนีคอลัมน์ที่จัดเรียงและลำดับการจัดเรียงพร้อมรายการจัดเรียงที่กำหนดเอง
public void AddKey(int key, SortOnType type, SortOrder order, object customList)
พารามิเตอร์
key
int
ดัชนีคอลัมน์ที่จัดเรียง (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
type
SortOnType
ประเภทค่าที่จัดเรียง
order
SortOrder
ลำดับการจัดเรียง
customList
object
รายการจัดเรียงที่กำหนดเอง
หมายเหตุ
หากประเภทเป็น SortOnType.CellColor หรือ SortOnType.FontColor, customList คือ Color
AddKey(int, SortOrder, string[])
เพิ่มดัชนีคอลัมน์ที่จัดเรียงและลำดับการจัดเรียงพร้อมรายการจัดเรียงที่กำหนดเอง
public void AddKey(int key, SortOrder order, string[] customList)
พารามิเตอร์
key
int
ดัชนีคอลัมน์ที่จัดเรียง (ตำแหน่งสัมบูรณ์, คอลัมน์ A คือ 0, B คือ 1, …)
order
SortOrder
ลำดับการจัดเรียง
customList
string[]
รายการจัดเรียงที่กำหนดเอง
Clear()
ล้างการตั้งค่าทั้งหมด
public void Clear()
Sort(Cells, int, int, int, int)
จัดเรียงข้อมูลในพื้นที่
public int[] Sort(Cells cells, int startRow, int startColumn, int endRow, int endColumn)
พารามิเตอร์
cells
Cells
เซลล์ที่มีพื้นที่ข้อมูล
startRow
int
แถวเริ่มต้นของพื้นที่
startColumn
int
คอลัมน์เริ่มต้นของพื้นที่
endRow
int
แถวสุดท้ายของพื้นที่
endColumn
int
คอลัมน์สุดท้ายของพื้นที่
คืนค่า
int[]
ดัชนีเดิม (ตำแหน่งสัมบูรณ์, เช่น คอลัมน์ A คือ 0, B คือ 1, …) ของแถว/คอลัมน์ที่จัดเรียง หากไม่มีแถว/คอลัมน์ใดที่ต้องย้ายโดยการจัดเรียงนี้ จะส่งคืน null
Sort(Cells, CellArea)
จัดเรียงข้อมูลในพื้นที่
public int[] Sort(Cells cells, CellArea area)
พารามิเตอร์
cells
Cells
เซลล์ที่มีพื้นที่ข้อมูล
area
CellArea
พื้นที่ที่ต้องจัดเรียง
คืนค่า
int[]
ดัชนีเดิม (ตำแหน่งสัมบูรณ์, เช่น คอลัมน์ A คือ 0, B คือ 1, …) ของแถว/คอลัมน์ที่จัดเรียง หากไม่มีแถว/คอลัมน์ใดที่ต้องย้ายโดยการจัดเรียงนี้ จะส่งคืน null
Sort()
จัดเรียงข้อมูลในช่วง
public int[] Sort()
คืนค่า
int[]
ดัชนีเดิม (ตำแหน่งสัมบูรณ์, เช่น คอลัมน์ A คือ 0, B คือ 1, …) ของแถว/คอลัมน์ที่จัดเรียง หากไม่มีแถว/คอลัมน์ใดที่ต้องย้ายโดยการจัดเรียงนี้ จะส่งคืน null