Class SeriesCollection

Class SeriesCollection

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

يجمع مجموعة من كائنات Aspose.Cells.Charts.Series.

public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable

الوراثة

objectCollectionBase<series>SeriesCollection

ينفذ

IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable

الأعضاء الموروثة

CollectionBase<series>.BinarySearch(Series), CollectionBase<series>.BinarySearch(Series, IComparer<series>), CollectionBase<series>.BinarySearch(int, int, Series, IComparer<series>), CollectionBase<series>.Contains(Series), CollectionBase<series>.CopyTo(Series[]), CollectionBase<series>.CopyTo(Series[], int), CollectionBase<series>.CopyTo(int, Series[], int, int), CollectionBase<series>.Exists(Predicate<series>), CollectionBase<series>.Find(Predicate<series>), CollectionBase<series>.FindAll(Predicate<series>), CollectionBase<series>.FindIndex(Predicate<series>), CollectionBase<series>.FindIndex(int, Predicate<series>), CollectionBase<series>.FindIndex(int, int, Predicate<series>), CollectionBase<series>.FindLast(Predicate<series>), CollectionBase<series>.FindLastIndex(Predicate<series>), CollectionBase<series>.FindLastIndex(int, Predicate<series>), CollectionBase<series>.FindLastIndex(int, int, Predicate<series>), CollectionBase<series>.IndexOf(Series), CollectionBase<series>.IndexOf(Series, int), CollectionBase<series>.IndexOf(Series, int, int), CollectionBase<series>.LastIndexOf(Series), CollectionBase<series>.LastIndexOf(Series, int), CollectionBase<series>.LastIndexOf(Series, int, int), CollectionBase<series>.GetEnumerator(), CollectionBase<series>.Clear(), CollectionBase<series>.RemoveAt(int), CollectionBase<series>.OnClearComplete(), CollectionBase<series>.OnClear(), CollectionBase<series>.Capacity, CollectionBase<series>.Count, CollectionBase<series>.InnerList, CollectionBase<series>.this[int], object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

أمثلة

//إنشاء كائن Workbook
Workbook workbook = new Workbook();
//إضافة ورقة عمل جديدة إلى كائن Excel
int sheetIndex = workbook.Worksheets.Add();
//الحصول على مرجع ورقة العمل المضافة حديثًا عن طريق تمرير فهرس الورقة
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//إضافة قيمة عينة إلى خلية "A1"
worksheet.Cells["A1"].PutValue(50);
//إضافة قيمة عينة إلى خلية "A2"
worksheet.Cells["A2"].PutValue(100);
//إضافة قيمة عينة إلى خلية "A3"
worksheet.Cells["A3"].PutValue(150);
//إضافة قيمة عينة إلى خلية "A4"
worksheet.Cells["A4"].PutValue(200);
//إضافة قيمة عينة إلى خلية "B1"
worksheet.Cells["B1"].PutValue(60);
//إضافة قيمة عينة إلى خلية "B2"
worksheet.Cells["B2"].PutValue(32);
//إضافة قيمة عينة إلى خلية "B3"
worksheet.Cells["B3"].PutValue(50);
//إضافة قيمة عينة إلى خلية "B4"
worksheet.Cells["B4"].PutValue(40);
//إضافة قيمة عينة إلى خلية "C1" كبيانات فئة
worksheet.Cells["C1"].PutValue("Q1");
//إضافة قيمة عينة إلى خلية "C2" كبيانات فئة
worksheet.Cells["C2"].PutValue("Q2");
//إضافة قيمة عينة إلى خلية "C3" كبيانات فئة
worksheet.Cells["C3"].PutValue("Y1");
//إضافة قيمة عينة إلى خلية "C4" كبيانات فئة
worksheet.Cells["C4"].PutValue("Y2");
//إضافة مخطط إلى ورقة العمل
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//الوصول إلى مثيل المخطط المضاف حديثًا
Chart chart = worksheet.Charts[chartIndex];
//إضافة NSeries (مصدر بيانات المخطط) إلى المخطط من خلية "A1" إلى "B4"
chart.NSeries.Add("A1:B4", true);
//تعيين مصدر البيانات لبيانات الفئة لـ NSeries
chart.NSeries.CategoryData = "C1:C4";
//حفظ ملف Excel
workbook.Save("book1.xls");
'إنشاء كائن Workbook
Dim workbook As Workbook = New Workbook()
'إضافة ورقة عمل جديدة إلى كائن Excel
Dim sheetIndex As Integer = workbook.Worksheets.Add()
'الحصول على مرجع ورقة العمل المضافة حديثًا عن طريق تمرير فهرس الورقة
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'إضافة قيمة عينة إلى خلية "A1"
worksheet.Cells("A1").PutValue(50)
'إضافة قيمة عينة إلى خلية "A2"
worksheet.Cells("A2").PutValue(100)
'إضافة قيمة عينة إلى خلية "A3"
worksheet.Cells("A3").PutValue(150)
'إضافة قيمة عينة إلى خلية "A4"
worksheet.Cells("A4").PutValue(200)
'إضافة قيمة عينة إلى خلية "B1"
worksheet.Cells("B1").PutValue(60)
'إضافة قيمة عينة إلى خلية "B2"
worksheet.Cells("B2").PutValue(32)
'إضافة قيمة عينة إلى خلية "B3"
worksheet.Cells("B3").PutValue(50)
'إضافة قيمة عينة إلى خلية "B4"
worksheet.Cells("B4").PutValue(40)
'إضافة قيمة عينة إلى خلية "C1" كبيانات فئة
worksheet.Cells("C1").PutValue("Q1")
'إضافة قيمة عينة إلى خلية "C2" كبيانات فئة
worksheet.Cells("C2").PutValue("Q2")
'إضافة قيمة عينة إلى خلية "C3" كبيانات فئة
worksheet.Cells("C3").PutValue("Y1")
'إضافة قيمة عينة إلى خلية "C4" كبيانات فئة
worksheet.Cells("C4").PutValue("Y2")
'إضافة مخطط إلى ورقة العمل
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'الوصول إلى مثيل المخطط المضاف حديثًا
Dim chart As Chart = worksheet.Charts(chartIndex)
'إضافة NSeries (مصدر بيانات المخطط) إلى المخطط من خلية "A1" إلى "B4"
chart.NSeries.Add("A1:B4", True)
'تعيين مصدر البيانات لبيانات الفئة لـ NSeries
chart.NSeries.CategoryData = "C1:C4"
'حفظ ملف Excel
workbook.Save("book1.xls")

الخصائص

CategoryData

يحصل على أو يحدد نطاق قيم محور الفئة. يمكن أن يكون نطاق خلايا (مثل، “d1:e10”)، أو تسلسل من القيم (مثل،"{2,6,8,10}").

public string CategoryData { get; set; }

قيمة الخاصية

string

IsColorVaried

يمثل ما إذا كان لون النقاط متنوعًا.

public bool IsColorVaried { get; set; }

قيمة الخاصية

bool

SecondCategoryData

يحصل على أو يحدد نطاق قيم محور الفئة الثانية. يمكن أن يكون نطاق خلايا (مثل، “d1:e10”)، أو تسلسل من القيم (مثل،"{2,6,8,10}"). يؤثر فقط عندما يتم رسم بعض ASerieses على المحور الثاني.

public string SecondCategoryData { get; set; }

قيمة الخاصية

string

this[int]

يحصل على عنصر Aspose.Cells.Charts.Series في الفهرس المحدد.

public Series this[int index] { get; }

قيمة الخاصية

Series

الطرق

Add(string, bool)

يضيف مجموعة Aspose.Cells.Charts.Series إلى مخطط.

public int Add(string area, bool isVertical)

المعلمات

area string

يحدد القيم التي سيتم رسم سلسلة البيانات منها.

isVertical bool

يحدد ما إذا كان سيتم رسم السلسلة من نطاق قيم الخلايا حسب الصف أو حسب العمود.

العائدات

int

يعود بأول فهرس لـ ASeries المضافة في NSeries.

الملاحظات


إذا تم تعيين البيانات على خلايا متجاورة، استخدم النقطتين لفصلها. على سبيل المثال، $C$2:$C$5.
إذا تم تعيين البيانات على خلايا غير متجاورة، استخدم الفاصلة لفصلها. على سبيل المثال: ($C$2,$D$5).

Add(string, bool, bool)

يضيف مجموعة Aspose.Cells.Charts.Series إلى مخطط.

public int Add(string area, bool isVertical, bool checkLabels)

المعلمات

area string

يحدد القيم التي سيتم رسم سلسلة البيانات منها.

isVertical bool

يحدد ما إذا كان سيتم رسم السلسلة من نطاق قيم الخلايا حسب الصف أو حسب العمود.

checkLabels bool

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

العائدات

int

يعود بأول فهرس لـ ASeries المضافة في NSeries.

الملاحظات


إذا تم تعيين البيانات على خلايا متجاورة، استخدم النقطتين لفصلها. على سبيل المثال، $C$2:$C$5.
إذا تم تعيين البيانات على خلايا غير متجاورة، استخدم الفاصلة لفصلها. على سبيل المثال، ($C$2,$D$5).

AddR1C1(string, bool)

يضيف مجموعة Aspose.Cells.Charts.Series إلى مخطط.

public int AddR1C1(string area, bool isVertical)

المعلمات

area string

يحدد القيم التي سيتم رسم سلسلة البيانات منها.

isVertical bool

يحدد ما إذا كان سيتم رسم السلسلة من نطاق قيم الخلايا حسب الصف أو حسب العمود.

العائدات

int

يعود بأول فهرس لـ ASeries المضافة في NSeries.

الملاحظات


إذا تم تعيين البيانات على خلايا متجاورة، استخدم النقطتين لفصلها. على سبيل المثال، R[1]C[1]:R[3]C[2].
إذا تم تعيين البيانات على خلايا غير متجاورة، استخدم الفاصلة لفصلها. على سبيل المثال، (R[1]C[1],R[3]C[2]).

Clear()

يمسح المجموعة.

public void Clear()

GetSeriesByOrder(int)

يحصل على عنصر Aspose.Cells.Charts.Series حسب الترتيب.

public Series GetSeriesByOrder(int order)

المعلمات

order int

ترتيب السلسلة.

العائدات

Series

عنصر السلسلة.

RemoveAt(int)

يزيل سلسلة عند الفهرس المحدد.

public void RemoveAt(int index)

المعلمات

index int

الفهرس.

SetSeriesNames(int, string, bool)

يحدد اسم جميع السلاسل في المخطط.

public void SetSeriesNames(int startIndex, string area, bool isVertical)

المعلمات

startIndex int

فهرس أول سلسلة تريد تعيين الاسم لها.

area string

يحدد المنطقة لاسم السلسلة.

isVertical bool

> يحدد ما إذا كان سيتم رسم السلسلة من نطاق قيم الخلايا حسب الصف أو حسب العمود.

الملاحظات


إذا كان فهرس البداية أكبر من عدد السلاسل، فسيرجع ولن يفعل شيئًا.
إذا تم تعيين البيانات على خلايا متجاورة، استخدم النقطتين لفصلها. على سبيل المثال، $C$2:$C$5.
إذا تم تعيين البيانات على خلايا غير متجاورة، استخدم الفاصلة لفصلها. على سبيل المثال، ($C$2,$D$5).

SwapSeries(int, int)

يغير مباشرة ترتيب سلسلتين.

public void SwapSeries(int sourceIndex, int destIndex)

المعلمات

sourceIndex int

الفهرس الحالي.

destIndex int

فهرس الوجهة.

 عربي