Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
يحتوي على كائن يمثل سلسلة بيانات واحدة في الرسم البياني.
public class Seriesالوراثة
الأعضاء الموروثة
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"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//تعيين مصدر البيانات لبيانات الفئة من NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//تعيين قيم السلسلة.
series.Values = "=B1:B4";
//تغيير نوع الرسم البياني للسلسلة.
series.Type = ChartType.Line;
//تعيين خصائص العلامات.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//قم بأعمالك
//حفظ ملف Excel
workbook.Save("book1.xls");'إنشاء كائن Workbook
Dim workbook As Workbook = New Workbook()
'إضافة ورقة عمل جديدة إلى كائن Excel
Dim sheetIndex As Int32 = 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 Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'الوصول إلى مثيل الرسم البياني المضاف حديثًا
Dim chart As Chart = worksheet.Charts(chartIndex)
'إضافة NSeries (مصدر بيانات الرسم البياني) إلى الرسم البياني من الخلية "A1" إلى "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'تعيين مصدر البيانات لبيانات الفئة من NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'تعيين قيم السلسلة.
series.Values = "=B1:B4"
'تغيير نوع الرسم البياني للسلسلة.
series.Type = ChartType.Line
'تعيين خصائص العلامات.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'حفظ ملف Excel
workbook.Save("book1.xls")الخصائص
Area
يمثل منطقة الخلفية لكائن Series.
public Area Area { get; }قيمة الخاصية
Bar3DShapeType
يحصل أو يحدد نوع الشكل ثلاثي الأبعاد المستخدم مع الرسم البياني العمودي ثلاثي الأبعاد.
public Bar3DShapeType Bar3DShapeType { get; set; }قيمة الخاصية
Border
يمثل حدود كائن Series.
public Line Border { get; }قيمة الخاصية
BubbleScale
يحصل أو يحدد عامل المقياس للفقاعات في مجموعة الرسم البياني المحددة. يمكن أن يكون قيمة صحيحة من 0 (صفر) إلى 300، تتوافق مع نسبة مئوية من الحجم الافتراضي. ينطبق فقط على الرسوم البيانية للفقاعات.
public int BubbleScale { get; set; }قيمة الخاصية
BubbleSizes
يحصل أو يحدد قيم أحجام الفقاعات لسلسلة الرسم البياني.
public string BubbleSizes { get; set; }قيمة الخاصية
CountOfDataValues
يحصل على عدد قيم البيانات.
public int CountOfDataValues { get; }قيمة الخاصية
DataLabels
يمثل كائن DataLabels للسلسلة المحددة.
public DataLabels DataLabels { get; }قيمة الخاصية
DisplayName
يحصل على اسم السلسلة الذي يعرض على الرسم البياني.
public string DisplayName { get; }قيمة الخاصية
DoughnutHoleSize
يعيد أو يحدد حجم الفتحة في مجموعة الرسم البياني الدائري. يتم التعبير عن حجم الفتحة كنسبة مئوية من حجم الرسم البياني، بين 10 و 90 في المئة.
public int DoughnutHoleSize { get; set; }قيمة الخاصية
DownBars
يعيد كائن Aspose.Cells.Charts.DropBars الذي يمثل الأشرطة السفلية على الرسم البياني الخطي. ينطبق فقط على الرسوم البيانية الخطية.
public DropBars DownBars { get; }قيمة الخاصية
DropLines
يعيد كائن Aspose.Cells.Drawing.Line الذي يمثل خطوط السقوط لسلسلة على الرسم البياني الخطي أو الرسم البياني المساحي. ينطبق فقط على الرسوم البيانية الخطية أو الرسوم البيانية المساحية.
public Line DropLines { get; }قيمة الخاصية
Explosion
تُعبر المسافة بين شريحة فطيرة مفتوحة من مركز الرسم البياني الدائري كنسبة مئوية من قطر الفطيرة.
public int Explosion { get; set; }قيمة الخاصية
FirstSliceAngle
يحصل على أو يحدد زاوية الشريحة الأولى من الرسم البياني الدائري أو الرسم البياني الدائري، بالدرجات (مع اتجاه عقارب الساعة من العمودي). ينطبق فقط على الرسوم البيانية الدائرية، والرسم البياني الدائري ثلاثي الأبعاد، والرسوم البيانية الدائرية، من 0 إلى 360.
public short FirstSliceAngle { get; set; }قيمة الخاصية
GapWidth
يعيد أو يحدد المسافة بين مجموعات الأعمدة أو الأشرطة، كنسبة مئوية من عرض العمود أو الشريط. يجب أن تكون قيمة هذه الخاصية بين 0 و 500.
public short GapWidth { get; set; }قيمة الخاصية
Has3DEffect
صحيح إذا كانت السلسلة لها مظهر ثلاثي الأبعاد. ينطبق فقط على الرسوم البيانية للفقاعات.
public bool Has3DEffect { get; set; }قيمة الخاصية
HasDropLines
صحيح إذا كان الرسم البياني يحتوي على خطوط سقوط. ينطبق فقط على الرسوم البيانية الخطية أو الرسوم البيانية المساحية.
public bool HasDropLines { get; set; }قيمة الخاصية
HasHiLoLines
صحيح إذا كان الرسم البياني الخطي يحتوي على خطوط عالية ومنخفضة. ينطبق فقط على الرسوم البيانية الخطية.
public bool HasHiLoLines { get; set; }قيمة الخاصية
HasLeaderLines
صحيح إذا كانت السلسلة تحتوي على خطوط رائدة.
public bool HasLeaderLines { get; set; }قيمة الخاصية
HasRadarAxisLabels
صحيح إذا كان الرسم البياني الراداري يحتوي على تسميات محور الفئة. ينطبق فقط على الرسوم البيانية الرادارية.
public bool HasRadarAxisLabels { get; set; }قيمة الخاصية
HasSeriesLines
صحيح إذا كان الرسم البياني العمودي المكدس أو الرسم البياني الشريطي المكدس يحتوي على خطوط السلسلة أو إذا كان الرسم البياني الدائري أو الرسم البياني الشريطي يحتوي على خطوط موصلة بين القسمين. ينطبق فقط على الرسوم البيانية العمودية المكدسة، والرسوم البيانية الشريطية، والرسوم البيانية الدائرية، أو الرسوم البيانية الشريطية.
public bool HasSeriesLines { get; set; }قيمة الخاصية
HasUpDownBars
صحيح إذا كان الرسم البياني الخطي يحتوي على أشرطة صعود وهبوط. ينطبق فقط على الرسوم البيانية الخطية.
public bool HasUpDownBars { get; set; }قيمة الخاصية
HiLoLines
يعيد كائن HiLoLines الذي يمثل خطوط الارتفاع والانخفاض لسلسلة على الرسم البياني الخطي. ينطبق فقط على الرسوم البيانية الخطية.
public Line HiLoLines { get; }قيمة الخاصية
IsAutoSplit
تشير إلى ما إذا كانت قيمة العتبة تلقائية.
public bool IsAutoSplit { get; }قيمة الخاصية
IsColorVaried
تمثل ما إذا كان لون النقاط متنوعًا. يجب أن يحتوي الرسم البياني على سلسلة واحدة فقط.
public bool IsColorVaried { get; set; }قيمة الخاصية
IsFiltered
تشير إلى ما إذا كانت السلسلة محددة أو مفلترة. صحيح يمثل أن هذه السلسلة مفلترة، وأنها لن تظهر على الرسم البياني.
public bool IsFiltered { get; set; }قيمة الخاصية
IsVerticalValues
تشير إلى ما إذا كانت مصدر البيانات عموديًا.
public bool IsVerticalValues { get; }قيمة الخاصية
LayoutProperties
يمثل خصائص التخطيط.
public SeriesLayoutProperties LayoutProperties { get; }قيمة الخاصية
LeaderLines
يمثل خطوط القيادة على الرسم البياني. تربط خطوط القيادة تسميات البيانات بالنقاط البيانية. هذا الكائن ليس مجموعة؛ لا يوجد كائن يمثل خط قيادة واحد.
public Line LeaderLines { get; }قيمة الخاصية
LegendEntry
يحصل على إدخال الأسطورة وفقًا لهذه السلسلة.
public LegendEntry LegendEntry { get; }قيمة الخاصية
Marker
يحصل على Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }قيمة الخاصية
Name
يحصل أو يحدد اسم سلسلة البيانات.
public string Name { get; set; }قيمة الخاصية
أمثلة
//الإشارة إلى اسم خلية
chart.NSeries[0].Name = "=A1";
//تعيين سلسلة كاسم
chart.NSeries[0].Name = "First Series";'الإشارة إلى اسم خلية
chart.NSeries[0].Name = "=A1"
'تعيين سلسلة كاسم
chart.NSeries[0].Name = "First Series"Overlap
تحدد كيفية وضع الأشرطة والأعمدة. يمكن أن تكون قيمة بين -100 و 100. ينطبق فقط على الرسوم البيانية العمودية ثنائية الأبعاد والرسوم البيانية العمودية.
public short Overlap { get; set; }قيمة الخاصية
PlotOnSecondAxis
تشير إلى ما إذا كانت هذه السلسلة مرسومة على المحور القيمي الثاني.
public bool PlotOnSecondAxis { get; set; }قيمة الخاصية
Points
يحصل على مجموعة النقاط في سلسلة في رسم بياني.
public ChartPointCollection Points { get; }قيمة الخاصية
ملاحظات
عندما يكون الرسم البياني هو فطيرة من فطيرة أو شريط من فطيرة، فإن النقطة الأخيرة هي نقطة أخرى في الرسم البياني الأول.
SecondPlotSize
يعيد أو يحدد حجم القسم الثانوي من إما رسم بياني دائري من فطيرة أو رسم بياني شريطي من فطيرة، كنسبة مئوية من حجم الفطيرة الأولية. يمكن أن تكون قيمة من 5 إلى 200.
public short SecondPlotSize { get; set; }قيمة الخاصية
SeriesLines
يعيد كائن SeriesLines الذي يمثل خطوط السلسلة لرسم بياني شريطي مكدس أو رسم بياني عمودي مكدس. ينطبق فقط على الرسوم البيانية الشريطية المكدسة والرسوم البيانية العمودية المكدسة.
public Line SeriesLines { get; }قيمة الخاصية
Shadow
صحيح إذا كانت السلسلة لها ظل.
public bool Shadow { get; set; }قيمة الخاصية
ShapeProperties
يحصل على كائن Aspose.Cells.Drawing.ShapePropertyCollection الذي يحمل الخصائص الشكلية المرئية للسلسلة.
public ShapePropertyCollection ShapeProperties { get; }قيمة الخاصية
ShowNegativeBubbles
صحيح إذا كانت الفقاعات السلبية تظهر لمجموعة الرسم البياني. صالحة فقط للرسوم البيانية للفقاعات.
public bool ShowNegativeBubbles { get; set; }قيمة الخاصية
SizeRepresents
يحصل أو يحدد ما تمثله حجم الفقاعات في الرسم البياني للفقاعات.
public BubbleSizeRepresents SizeRepresents { get; set; }قيمة الخاصية
ملاحظات
BubbleSizeRepresents.SizeIsArea تعني أن القيمة Aspose.Cells.Charts.Series.BubbleSizes هي مساحة الفقاعة. BubbleSizeRepresents.SizeIsWidth تعني أن القيمة Aspose.Cells.Charts.Series.BubbleSizes هي عرض الفقاعة.
Smooth
يمثل تنعيم المنحنى. صحيح إذا تم تفعيل تنعيم المنحنى للرسم البياني الخطي أو الرسم البياني المتناثر. ينطبق فقط على الرسوم البيانية الخطية والمتناثرة المتصلة بالخطوط.
public bool Smooth { get; set; }قيمة الخاصية
SplitType
يعيد أو يحدد قيمة تحدد كيفية تحديد النقاط البيانية التي تكون في الفطيرة الثانية أو الشريط الثاني في رسم بياني دائري من فطيرة أو شريط من فطيرة.
public ChartSplitType SplitType { get; set; }قيمة الخاصية
SplitValue
يعيد أو يحدد قيمة ستستخدم لتحديد النقاط البيانية التي تكون في الفطيرة الثانية أو الشريط الثاني في رسم بياني دائري من فطيرة أو شريط من فطيرة.
public double SplitValue { get; set; }قيمة الخاصية
TrendLines
يعيد جميع خطوط الاتجاه لهذه السلسلة.
public TrendlineCollection TrendLines { get; }قيمة الخاصية
Type
يحصل أو يحدد نوع سلسلة البيانات.
public ChartType Type { get; set; }قيمة الخاصية
UpBars
يعيد كائن DropBars الذي يمثل الأشرطة العلوية على الرسم البياني الخطي. ينطبق فقط على الرسوم البيانية الخطية.
public DropBars UpBars { get; }قيمة الخاصية
Values
يمثل قيم Y لهذه السلسلة في الرسم البياني.
public string Values { get; set; }قيمة الخاصية
ValuesFormatCode
يمثل رمز تنسيق لقائمة أرقام Values.
public string ValuesFormatCode { get; set; }قيمة الخاصية
XErrorBar
يمثل شريط الخطأ في اتجاه X للسلسلة.
public ErrorBar XErrorBar { get; }قيمة الخاصية
XValues
يمثل قيم x لسلسلة الرسم البياني.
public string XValues { get; set; }قيمة الخاصية
XValuesFormatCode
يمثل رمز تنسيق لقائمة أرقام X Values.
public string XValuesFormatCode { get; set; }قيمة الخاصية
YErrorBar
يمثل شريط الخطأ في اتجاه Y للسلسلة.
public ErrorBar YErrorBar { get; }قيمة الخاصية
الطرق
Move(int)
ينقل السلسلة لأعلى أو لأسفل.
public void Move(int count)المعلمات
count int
عدد التحرك لأعلى أو لأسفل. انقل السلسلة لأعلى إذا كانت هذه القيمة أقل من صفر؛ انقل السلسلة لأسفل إذا كانت هذه القيمة أكبر من صفر.
