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
الوراثة
object ← CollectionBase<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; }
قيمة الخاصية
IsColorVaried
يمثل ما إذا كان لون النقاط متنوعًا.
public bool IsColorVaried { get; set; }
قيمة الخاصية
SecondCategoryData
يحصل على أو يحدد نطاق قيم محور الفئة الثانية. يمكن أن يكون نطاق خلايا (مثل، “d1:e10”)، أو تسلسل من القيم (مثل،"{2,6,8,10}"). يؤثر فقط عندما يتم رسم بعض ASerieses على المحور الثاني.
public string SecondCategoryData { get; set; }
قيمة الخاصية
this[int]
يحصل على عنصر Aspose.Cells.Charts.Series في الفهرس المحدد.
public Series this[int index] { get; }
قيمة الخاصية
الطرق
Add(string, bool)
يضيف مجموعة Aspose.Cells.Charts.Series إلى مخطط.
public int Add(string area, bool isVertical)
المعلمات
area
string
يحدد القيم التي سيتم رسم سلسلة البيانات منها.
isVertical
bool
يحدد ما إذا كان سيتم رسم السلسلة من نطاق قيم الخلايا حسب الصف أو حسب العمود.
العائدات
يعود بأول فهرس لـ 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
تشير إلى ما إذا كان النطاق يحتوي على اسم السلسلة.
العائدات
يعود بأول فهرس لـ 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
يحدد ما إذا كان سيتم رسم السلسلة من نطاق قيم الخلايا حسب الصف أو حسب العمود.
العائدات
يعود بأول فهرس لـ 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
ترتيب السلسلة.
العائدات
عنصر السلسلة.
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
فهرس الوجهة.