Class Series

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

شیء را که نمایانگر یک سری داده در یک نمودار است، محصور می‌کند.

public class Series

وراثت

object ← 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; }

مقدار ویژگی

Area

Bar3DShapeType

نوع شکل سه‌بعدی مورد استفاده در نمودار میله‌ای یا ستونی سه‌بعدی را دریافت یا تنظیم می‌کند.

public Bar3DShapeType Bar3DShapeType { get; set; }

مقدار ویژگی

Bar3DShapeType

Border

نمایانگر حاشیه شیء Series است.

public Line Border { get; }

مقدار ویژگی

Line

BubbleScale

مقدار مقیاس برای حباب‌ها در گروه نمودار مشخص شده را دریافت یا تنظیم می‌کند. این می‌تواند یک مقدار صحیح از 0 (صفر) تا 300 باشد، که معادل درصدی از اندازه پیش‌فرض است. تنها به نمودارهای حباب اعمال می‌شود.

public int BubbleScale { get; set; }

مقدار ویژگی

int

BubbleSizes

مقدار اندازه‌های حباب‌های سری نمودار را دریافت یا تنظیم می‌کند.

public string BubbleSizes { get; set; }

مقدار ویژگی

string

CountOfDataValues

تعداد مقادیر داده را دریافت می‌کند.

public int CountOfDataValues { get; }

مقدار ویژگی

int

DataLabels

نمایانگر شیء DataLabels برای ASeries مشخص شده است.

public DataLabels DataLabels { get; }

مقدار ویژگی

DataLabels

DisplayName

نام سری که در نمودار نمایش داده می‌شود را دریافت می‌کند.

public string DisplayName { get; }

مقدار ویژگی

string

DoughnutHoleSize

اندازه حفره در گروه نمودار دونات را برمی‌گرداند یا تنظیم می‌کند. اندازه حفره به عنوان درصدی از اندازه نمودار بیان می‌شود، بین 10 تا 90 درصد.

public int DoughnutHoleSize { get; set; }

مقدار ویژگی

int

DownBars

یک شیء Aspose.Cells.Charts.DropBars را برمی‌گرداند که نمایانگر نوارهای پایین در یک نمودار خطی است. تنها به نمودارهای خطی اعمال می‌شود.

public DropBars DownBars { get; }

مقدار ویژگی

DropBars

DropLines

یک شیء Aspose.Cells.Drawing.Line را برمی‌گرداند که نمایانگر خطوط افت برای یک سری در نمودار خطی یا نمودار منطقه‌ای است. تنها به نمودارهای خطی یا منطقه‌ای اعمال می‌شود.

public Line DropLines { get; }

مقدار ویژگی

Line

Explosion

فاصله یک برش پای باز از مرکز نمودار پای به عنوان درصدی از قطر پای بیان می‌شود.

public int Explosion { get; set; }

مقدار ویژگی

int

FirstSliceAngle

زاویه اولین برش نمودار پای یا نمودار دونات را در درجه (ساعت‌گرد از عمودی) دریافت یا تنظیم می‌کند. تنها به نمودارهای پای، پای سه‌بعدی و دونات، 0 تا 360 اعمال می‌شود.

public short FirstSliceAngle { get; set; }

مقدار ویژگی

short

GapWidth

فضای بین خوشه‌های میله یا ستون را به عنوان درصدی از عرض میله یا ستون برمی‌گرداند یا تنظیم می‌کند. مقدار این ویژگی باید بین 0 و 500 باشد.

public short GapWidth { get; set; }

مقدار ویژگی

short

Has3DEffect

اگر سری ظاهری سه‌بعدی داشته باشد، درست است. تنها به نمودارهای حبابی اعمال می‌شود.

public bool Has3DEffect { get; set; }

مقدار ویژگی

bool

HasDropLines

اگر نمودار دارای خطوط افت باشد، درست است. تنها به نمودارهای خطی یا منطقه‌ای اعمال می‌شود.

public bool HasDropLines { get; set; }

مقدار ویژگی

bool

HasHiLoLines

اگر نمودار خطی دارای خطوط بالا-پایین باشد، درست است. تنها به نمودارهای خطی اعمال می‌شود.

public bool HasHiLoLines { get; set; }

مقدار ویژگی

bool

HasLeaderLines

اگر سری دارای خطوط راهنما باشد، درست است.

public bool HasLeaderLines { get; set; }

مقدار ویژگی

bool

HasRadarAxisLabels

اگر یک نمودار راداری دارای برچسب‌های محور دسته باشد، درست است. تنها به نمودارهای راداری اعمال می‌شود.

public bool HasRadarAxisLabels { get; set; }

مقدار ویژگی

bool

HasSeriesLines

اگر یک نمودار ستونی یا میله‌ای انباشته دارای خطوط سری باشد یا اگر یک نمودار پای از پای یا یک نمودار میله‌ای از پای دارای خطوط اتصال بین دو بخش باشد. تنها به نمودارهای ستونی انباشته، نمودارهای میله‌ای، نمودارهای پای از پای یا نمودارهای میله‌ای از پای اعمال می‌شود.

public bool HasSeriesLines { get; set; }

مقدار ویژگی

bool

HasUpDownBars

اگر یک نمودار خطی دارای نوارهای بالا و پایین باشد، درست است. تنها به نمودارهای خطی اعمال می‌شود.

public bool HasUpDownBars { get; set; }

مقدار ویژگی

bool

HiLoLines

یک شیء HiLoLines را برمی‌گرداند که نمایانگر خطوط بالا-پایین برای یک سری در یک نمودار خطی است. تنها به نمودارهای خطی اعمال می‌شود.

public Line HiLoLines { get; }

مقدار ویژگی

Line

IsAutoSplit

نشان می‌دهد که آیا مقدار آستانه خودکار است.

public bool IsAutoSplit { get; }

مقدار ویژگی

bool

IsColorVaried

نشان می‌دهد که آیا رنگ نقاط متفاوت است. نمودار باید فقط یک سری داشته باشد.

public bool IsColorVaried { get; set; }

مقدار ویژگی

bool

IsFiltered

نشان می‌دهد که آیا سری انتخاب شده یا فیلتر شده است. درست نشان‌دهنده این است که این سری فیلتر شده است و در نمودار نمایش داده نخواهد شد.

public bool IsFiltered { get; set; }

مقدار ویژگی

bool

IsVerticalValues

نشان می‌دهد که آیا منبع داده عمودی است.

public bool IsVerticalValues { get; }

مقدار ویژگی

bool

LayoutProperties

نمایانگر ویژگی‌های چیدمان است.

public SeriesLayoutProperties LayoutProperties { get; }

مقدار ویژگی

SeriesLayoutProperties

LeaderLines

نمایانگر خطوط راهنما در یک نمودار است. خطوط راهنما برچسب‌های داده را به نقاط داده متصل می‌کنند. این شیء یک مجموعه نیست؛ هیچ شیء‌ای وجود ندارد که نمایانگر یک خط راهنما باشد.

public Line LeaderLines { get; }

مقدار ویژگی

Line

LegendEntry

ورودی افسانه‌ای را بر اساس این سری دریافت می‌کند.

public LegendEntry LegendEntry { get; }

مقدار ویژگی

LegendEntry

Marker

نشان‌دهنده Aspose.Cells.Charts.Series.Marker?text=marker را دریافت می‌کند.

public Marker Marker { get; }

مقدار ویژگی

Marker

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 باشد. تنها به نمودارهای میله‌ای 2D و نمودارهای ستونی 2D اعمال می‌شود.

public short Overlap { get; set; }

مقدار ویژگی

short

PlotOnSecondAxis

نشان می‌دهد که آیا این سری بر روی محور مقدار دوم ترسیم شده است.

public bool PlotOnSecondAxis { get; set; }

مقدار ویژگی

bool

Points

مجموعه‌ای از نقاط در یک سری در یک نمودار را دریافت می‌کند.

public ChartPointCollection Points { get; }

مقدار ویژگی

ChartPointCollection

یادداشت‌ها

هنگامی که نمودار پای از پای یا میله‌ای از پای باشد، آخرین نقطه، نقطه دیگری در اولین نمودار پای است.

SecondPlotSize

اندازه بخش ثانویه یک نمودار پای از پای یا یک نمودار میله‌ای از پای را برمی‌گرداند یا تنظیم می‌کند، به عنوان درصدی از اندازه پای اصلی. می‌تواند مقداری از 5 تا 200 باشد.

public short SecondPlotSize { get; set; }

مقدار ویژگی

short

SeriesLines

یک شیء SeriesLines را برمی‌گرداند که نمایانگر خطوط سری برای یک نمودار میله‌ای انباشته یا یک نمودار ستونی انباشته است. تنها به نمودارهای میله‌ای انباشته و ستونی انباشته اعمال می‌شود.

public Line SeriesLines { get; }

مقدار ویژگی

Line

Shadow

اگر سری سایه داشته باشد، درست است.

public bool Shadow { get; set; }

مقدار ویژگی

bool

ShapeProperties

شیء Aspose.Cells.Drawing.ShapePropertyCollection را دریافت می‌کند که ویژگی‌های بصری شکل سری را نگه می‌دارد.

public ShapePropertyCollection ShapeProperties { get; }

مقدار ویژگی

ShapePropertyCollection

ShowNegativeBubbles

اگر حباب‌های منفی برای گروه نمودار نمایش داده شوند، درست است. فقط برای نمودارهای حبابی معتبر است.

public bool ShowNegativeBubbles { get; set; }

مقدار ویژگی

bool

SizeRepresents

آنچه که اندازه حباب در یک نمودار حبابی نمایانگر است را دریافت یا تنظیم می‌کند.

public BubbleSizeRepresents SizeRepresents { get; set; }

مقدار ویژگی

BubbleSizeRepresents

یادداشت‌ها

BubbleSizeRepresents.SizeIsArea به این معنی است که مقدار Aspose.Cells.Charts.Series.BubbleSizes مساحت حباب است. BubbleSizeRepresents.SizeIsWidth به این معنی است که مقدار Aspose.Cells.Charts.Series.BubbleSizes عرض حباب است.

Smooth

نشان‌دهنده همواری منحنی است. اگر همواری منحنی برای نمودار خطی یا نمودار پراکنده روشن باشد، درست است. تنها به نمودارهای خطی و پراکنده متصل به خطوط اعمال می‌شود.

public bool Smooth { get; set; }

مقدار ویژگی

bool

SplitType

مقداری را برمی‌گرداند یا تنظیم می‌کند که چگونه نقاط داده را در نمودار پای از پای یا میله‌ای از پای تعیین می‌کند.

public ChartSplitType SplitType { get; set; }

مقدار ویژگی

ChartSplitType

SplitValue

مقداری را برمی‌گرداند یا تنظیم می‌کند که برای تعیین نقاط داده‌ای که در دومین پای یا میله در نمودار پای از پای یا میله‌ای از پای استفاده می‌شود، به کار می‌رود.

public double SplitValue { get; set; }

مقدار ویژگی

double

TrendLines

تمام خطوط روند این سری را برمی‌گرداند.

public TrendlineCollection TrendLines { get; }

مقدار ویژگی

TrendlineCollection

Type

نوع یک سری داده را دریافت یا تنظیم می‌کند.

public ChartType Type { get; set; }

مقدار ویژگی

ChartType

UpBars

یک شیء DropBars را برمی‌گرداند که نمایانگر نوارهای بالا در یک نمودار خطی است. تنها به نمودارهای خطی اعمال می‌شود.

public DropBars UpBars { get; }

مقدار ویژگی

DropBars

Values

نمایانگر مقادیر Y این سری نمودار است.

public string Values { get; set; }

مقدار ویژگی

string

ValuesFormatCode

نمایانگر کد فرمت لیست شماره‌های مقادیر است.

public string ValuesFormatCode { get; set; }

مقدار ویژگی

string

XErrorBar

نمایانگر خطای X در جهت سری است.

public ErrorBar XErrorBar { get; }

مقدار ویژگی

ErrorBar

XValues

نمایانگر مقادیر x سری نمودار است.

public string XValues { get; set; }

مقدار ویژگی

string

XValuesFormatCode

نمایانگر کد فرمت لیست شماره‌های X Values است.

public string XValuesFormatCode { get; set; }

مقدار ویژگی

string

YErrorBar

نمایانگر خطای Y در جهت سری است.

public ErrorBar YErrorBar { get; }

مقدار ویژگی

ErrorBar

متدها

Move(int)

سری را به بالا یا پایین حرکت می‌دهد.

public void Move(int count)

پارامترها

count int

تعداد حرکت به بالا یا پایین. سری را به بالا حرکت دهید اگر این کمتر از صفر باشد؛ سری را به پایین حرکت دهید اگر این بیشتر از صفر باشد.