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}"). משפיע רק כאשר כמה ASeries מצויירים על הציר השני.
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
אינדקס היעד