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")
תכונות
אזור
מייצג את אזור הרקע של אובייקט סדרה.
public Area Area { get; }
ערך תכונה
סוג צורת Bar3D
מקבל או מגדיר את סוג הצורה התלת-ממדית המשמשת עם גרף עמודות או בר תלת-ממדי.
public Bar3DShapeType Bar3DShapeType { get; set; }
ערך תכונה
גבול
מייצג את הגבול של אובייקט סדרה.
public Line Border { get; }
ערך תכונה
סקאלת בועות
מקבל או מגדיר את גורם הסקאלה עבור בועות בקבוצת הגרפים המצוינת. זה יכול להיות ערך שלם מ-0 (אפס) עד 300, המייצג אחוז מהגודל ברירת המחדל. חל רק על גרפי בועות.
public int BubbleScale { get; set; }
ערך תכונה
גדלי בועות
מקבל או מגדיר את ערכי גדלי הבועות של סדרת הגרף.
public string BubbleSizes { get; set; }
ערך תכונה
מספר ערכי הנתונים
מקבל את מספר ערכי הנתונים.
public int CountOfDataValues { get; }
ערך תכונה
תוויות נתונים
מייצג את אובייקט תוויות הנתונים עבור ASeries המצוינת.
public DataLabels DataLabels { get; }
ערך תכונה
שם תצוגה
מקבל את שם הסדרה שמוצג על הגרף.
public string DisplayName { get; }
ערך תכונה
גודל חור הדונאט
מחזיר או מגדיר את גודל החור בקבוצת הגרפים של הדונאט. גודל החור מתבטא כאחוז מגודל הגרף, בין 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; }
ערך תכונה
פיצוץ
המרחק של פרוסת פאי פתוחה ממרכז הגרף מתבטא כאחוז מקוטר הפאי.
public int Explosion { get; set; }
ערך תכונה
זווית פרוסת הפאי הראשונה
מקבל או מגדיר את הזווית של פרוסת הגרף פאי או הדונאט הראשונה, במעלות (כיוונים לפי השעון מוורטיקל). חל רק על גרפי פאי, פאי תלת-ממדי וגרפי הדונאט, בין 0 ל-360.
public short FirstSliceAngle { get; set; }
ערך תכונה
רוחב הפער
מחזיר או מגדיר את המרחק בין קבוצות העמודות או הברות, כאחוז מרוחב העמודה או הבר. ערך תכונה זו חייב להיות בין 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; }
ערך תכונה
תכונות פריסת סדרה
מייצג את תכונות הפריסה.
public SeriesLayoutProperties LayoutProperties { get; }
ערך תכונה
LeaderLines
מייצג קווי מנהיג בגרף. קווי מנהיג מחברים בין תוויות נתונים לנקודות נתונים. אובייקט זה אינו אוסף; אין אובייקט המייצג קו מנהיג בודד.
public Line LeaderLines { get; }
ערך תכונה
LegendEntry
מקבל את ערך האגדה לפי סדרה זו.
public LegendEntry LegendEntry { get; }
ערך תכונה
סימן
מקבל את Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }
ערך תכונה
שם
מקבל או מגדיר את שם סדרת הנתונים.
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"
חפיפה
מציין כיצד העמודות ממוקמות. יכול להיות ערך בין -100 ל-100. חל רק על גרפי עמודות וגרפי בר דו-ממדיים.
public short Overlap { get; set; }
ערך תכונה
PlotOnSecondAxis
מציין אם סדרה זו מוצגת על ציר הערך השני.
public bool PlotOnSecondAxis { get; set; }
ערך תכונה
נקודות
מקבל את האוסף של נקודות בסדרה בגרף.
public ChartPointCollection Points { get; }
ערך תכונה
הערות
כאשר הגרף הוא פאי של פאי או בר של פאי, הנקודה האחרונה היא נקודה אחרת בגרף הפאי הראשון.
גודל פלוט שני
מחזיר או מגדיר את גודל הקטע המשני של גרף פאי של פאי או גרף בר של פאי, כאחוז מגודל הפאי הראשי. יכול להיות ערך בין 5 ל-200.
public short SecondPlotSize { get; set; }
ערך תכונה
SeriesLines
מחזיר אובייקט SeriesLines המייצג את קווי הסדרה עבור גרף בר מצטבר או גרף עמודות מצטבר. חל רק על גרפי בר מצטברים וגרפי עמודות מצטברים.
public Line SeriesLines { get; }
ערך תכונה
צל
נכון אם לסדרה יש צל.
public bool Shadow { get; set; }
ערך תכונה
תכונות צורה
מגביר את אובייקט 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 הוא רוחב הבועה.
חלקה
מייצג החלקה של עקומות. נכון אם החלקה של העקומה מופעלת עבור גרף קו או גרף פיזור. חל רק על גרפי קו ופיזור המחוברים באמצעות קווים.
public bool Smooth { get; set; }
ערך תכונה
SplitType
מחזיר או מגדיר ערך המצביע כיצד לקבוע אילו נקודות נתונים נמצאות בפאי השני או בבר בגרף פאי של פאי או בר של פאי.
public ChartSplitType SplitType { get; set; }
ערך תכונה
SplitValue
מחזיר או מגדיר ערך שישמש לקביעת אילו נקודות נתונים נמצאות בפאי השני או בבר על גרף פאי של פאי או בר של פאי.
public double SplitValue { get; set; }
ערך תכונה
TrendLines
מחזיר את כל קווי המגמה של סדרה זו.
public TrendlineCollection TrendLines { get; }
ערך תכונה
סוג
מקבל או מגדיר את סוג סדרת הנתונים.
public ChartType Type { get; set; }
ערך תכונה
UpBars
מחזיר אובייקט DropBars המייצג את העמודות העליונות בגרף קו. חל רק על גרפי קו.
public DropBars UpBars { get; }
ערך תכונה
ערכים
מייצג את ערכי ה-Y של סדרת הגרף הזו.
public string Values { get; set; }
ערך תכונה
ValuesFormatCode
מייצג את קוד הפורמט של רשימת המספרים של הערכים.
public string ValuesFormatCode { get; set; }
ערך תכונה
XErrorBar
מייצג את קו השגיאה בכיוון X של הסדרה.
public ErrorBar XErrorBar { get; }
ערך תכונה
XValues
מייצג את ערכי ה-X של סדרת הגרף.
public string XValues { get; set; }
ערך תכונה
XValuesFormatCode
מייצג את קוד הפורמט של רשימת המספרים של ערכי ה-X.
public string XValuesFormatCode { get; set; }
ערך תכונה
YErrorBar
מייצג את קו השגיאה בכיוון Y של הסדרה.
public ErrorBar YErrorBar { get; }
ערך תכונה
שיטות
Move(int)
מעביר את הסדרה למעלה או למטה.
public void Move(int count)
פרמטרים
count
int
מספר ההעברות למעלה או למטה. העבר את הסדרה למעלה אם זה פחות מאפס; העבר את הסדרה למטה אם זה יותר מאפס.