Class DataSorter

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

ملخص الوصف لـ DataSorter.

public class DataSorter

الوراثة

object ← 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 الخاص بالدفتر.
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);
//حفظ ملف الإكسل.
workbook.Save("outBook.xls");

'إنشاء كائن Workbook جديد.
Dim workbook As Workbook = New Workbook("Book1.xls")
'الحصول على كائن datasorter الخاص بالدفتر.
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)
'حفظ ملف الإكسل.
workbook.Save("outBook.xls")

الخصائص

CaseSensitive

يحصل على أو يحدد ما إذا كان حساسًا لحالة الأحرف عند مقارنة السلاسل.

public bool CaseSensitive { get; set; }

قيمة الخاصية

bool

HasHeaders

يمثل ما إذا كان النطاق يحتوي على رؤوس.

public bool HasHeaders { get; set; }

قيمة الخاصية

bool

Key1

يمثل فهرس العمود الأول المرتب (الموقع المطلق، العمود A هو 0، B هو 1، …).

public int Key1 { get; set; }

قيمة الخاصية

int

Key2

يمثل فهرس العمود الثاني المرتب (الموقع المطلق، العمود A هو 0، B هو 1، …).

public int Key2 { get; set; }

قيمة الخاصية

int

Key3

يمثل فهرس العمود الثالث المرتب (الموقع المطلق، العمود A هو 0، B هو 1، …).

public int Key3 { get; set; }

قيمة الخاصية

int

Keys

يحصل على قائمة المفاتيح لمحدد البيانات.

public DataSorterKeyCollection Keys { get; }

قيمة الخاصية

DataSorterKeyCollection

Order1

يمثل ترتيب الفرز للمفتاح الأول.

public SortOrder Order1 { get; set; }

قيمة الخاصية

SortOrder

Order2

يمثل ترتيب الفرز للمفتاح الثاني.

public SortOrder Order2 { get; set; }

قيمة الخاصية

SortOrder

Order3

يمثل ترتيب الفرز للمفتاح الثالث.

public SortOrder Order3 { get; set; }

قيمة الخاصية

SortOrder

SortAsNumber

تشير إلى ما إذا كان يجب فرز أي شيء يبدو كرقم.

public bool SortAsNumber { get; set; }

قيمة الخاصية

bool

SortLeftToRight

يعني true أن اتجاه الفرز من اليسار إلى اليمين.
يعني false أن اتجاه الفرز من الأعلى إلى الأسفل.
القيمة الافتراضية هي false.

public bool SortLeftToRight { get; set; }

قيمة الخاصية

bool

الطرق

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[]

Sort()

يفرز البيانات في النطاق.

public int[] Sort()

العائدات

int[]