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
ایندکس مقصد
