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

لیست مرتب‌سازی سفارشی.

توضیحات

اگر type برابر 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[]