ایجاد یا بهروزرسانی نمودارهای ارائه PowerPoint در .NET
نمای کلی
این مقاله راهنمای جامعی برای ایجاد و سفارشیسازی نمودارها با استفاده از Aspose.Slides برای .NET ارائه میدهد. شما یاد میگیرید چگونه بهصورت برنامهنویسی یک نمودار را به اسلاید اضافه کنید، آن را با دادهها پر کنید و گزینههای قالببندی مختلفی را برای برآورده کردن نیازهای طراحی خاص خود اعمال کنید. در طول مقاله، مثالهای کد دقیق هر گام را نشان میدهند، از مقداردهی اولیه ارائه و شیء نمودار تا پیکربندی سریها، محورها و لیژن‑ها. با دنبال کردن این راهنما، درک جامعی از نحوه ادغام تولید دینامیک نمودارها در برنامههای .NET خود به دست میآورید و فرآیند ایجاد ارائههای داده‑محور را ساده میکنید.
ایجاد یک نمودار
نمودارها به افراد کمک میکنند تا دادهها را بهسرعت بهصورت تصویری درک کنند و بینشهایی بهدست آورند که ممکن است از یک جدول یا صفحهگسترده بهسادگی واضح نباشد.
چرا نمودارها را ایجاد کنیم؟
با استفاده از نمودارها میتوانید:
- مقدارهای زیادی از دادهها را در یک اسلاید جمع‑آوری، فشرده یا خلاصه کنید؛
- الگوها و روندهای داده را آشکار کنید؛
- جهت و سرعت تغییرات داده را در طول زمان یا نسبت به یک واحد اندازهگیری خاص استنتاج کنید؛
- ناهماهنگیها، انحرافات، خطاها و دادههای بیمعنی را شناسایی کنید؛
- دادههای پیچیده را ارتباط یا ارائه دهید.
در PowerPoint میتوانید نمودارها را از طریق عملکرد Insert ایجاد کنید که قالبهایی برای طراحی انواع مختلف نمودارها فراهم میکند. با Aspose.Slides میتوانید هر دو نوع نمودار معمولی (بر پایه انواع محبوب نمودار) و نمودارهای سفارشی را ایجاد کنید.
توجه
از شمارنده ChartType در فضای نام Aspose.Slides.Charts استفاده کنید. مقادیر این شمارنده با انواع مختلف نمودارها مطابقت دارد.ایجاد نمودارهای ستونی خوشهای
این مثال از AddChart برای ایجاد یک نمودار ستونی خوشهای که دو سری را در سه دسته مقایسه میکند، استفاده میکند. سریها از پر شدنهای قرمز و سبز استفاده میکنند و برچسبهای جداگانه نام دستهها، نام سریها و مقادیر را نشان میدهند. ایندکس کاربرگ ۰ به اولین شیت در کتابکارامدنهگذاری شده اشاره دارد.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 300);
chart.ChartTitle.AddTextFrameForOverriding("Sample Title");
chart.ChartTitle.TextFrameForOverriding.TextFrameFormat.CenterText = NullableBool.True;
chart.ChartTitle.Height = 20;
chart.HasTitle = true;
var workbook = chart.ChartData.ChartDataWorkbook;
var worksheetIndex = 0;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var seriesNameCell = workbook.GetCell(worksheetIndex, 0, 1, "Series 1");
chart.ChartData.Series.Add(seriesNameCell, chart.Type);
seriesNameCell = workbook.GetCell(worksheetIndex, 0, 2, "Series 2");
chart.ChartData.Series.Add(seriesNameCell, chart.Type);
var categoryCell = workbook.GetCell(worksheetIndex, 1, 0, "Category 1");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(worksheetIndex, 2, 0, "Category 2");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(worksheetIndex, 3, 0, "Category 3");
chart.ChartData.Categories.Add(categoryCell);
var series = chart.ChartData.Series[0];
var valueCell = workbook.GetCell(worksheetIndex, 1, 1, 20);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 1, 50);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 1, 30);
series.DataPoints.AddDataPointForBarSeries(valueCell);
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = Color.Red;
series = chart.ChartData.Series[1];
valueCell = workbook.GetCell(worksheetIndex, 1, 2, 30);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 2, 10);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 2, 60);
series.DataPoints.AddDataPointForBarSeries(valueCell);
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = Color.Green;
var label = series.DataPoints[0].Label;
label.DataLabelFormat.ShowCategoryName = true;
label = series.DataPoints[1].Label;
label.DataLabelFormat.ShowSeriesName = true;
label = series.DataPoints[2].Label;
label.DataLabelFormat.ShowValue = true;
label.DataLabelFormat.ShowSeriesName = true;
label.DataLabelFormat.Separator = "/";
presentation.Save("AsposeChart.pptx", SaveFormat.Pptx);
نتیجه:

ایجاد نمودارهای پراکندگی
نمودارهای پراکندگی (که به عنوان نمودارهای scatter یا گرافهای x‑y نیز شناخته میشوند) اغلب برای بررسی الگوها یا نشان دادن هم‑بستگی بین دو متغیر استفاده میشوند.
از نمودار پراکندگی وقتی استفاده کنید که:
- دادههای عددی جفت‑جفت دارید؛
- دو متغیر دارید که بهخوبی با هم جفت میشوند؛
- میخواهید تعیین کنید آیا دو متغیر مرتبط هستند یا نه؛
- یک متغیر مستقل دارید که برای یک متغیر وابسته مقادیر متعددی دارد.
این مثال دو مجموعهٔ مقادیر x‑y را رسم میکند. سری اول از خطوط مستقیم با نشانگرهای ستارهای، در حالی که سری دوم از خطوط صاف با نشانگرهای دایرهای استفاده میکند؛ هر دو از Size برابر ۱۰ استفاده میکنند. ویژگی Symbol شکل نشانگر را کنترل میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ScatterWithSmoothLines, 20, 20, 500, 300);
var workbook = chart.ChartData.ChartDataWorkbook;
var worksheetIndex = 0;
chart.ChartData.Series.Clear();
var seriesNameCell = workbook.GetCell(worksheetIndex, 1, 1, "Series 1");
chart.ChartData.Series.Add(seriesNameCell, chart.Type);
seriesNameCell = workbook.GetCell(worksheetIndex, 1, 3, "Series 2");
chart.ChartData.Series.Add(seriesNameCell, chart.Type);
var series = chart.ChartData.Series[0];
var xValueCell = workbook.GetCell(worksheetIndex, 2, 1, 1);
var yValueCell = workbook.GetCell(worksheetIndex, 2, 2, 3);
series.DataPoints.AddDataPointForScatterSeries(xValueCell, yValueCell);
xValueCell = workbook.GetCell(worksheetIndex, 3, 1, 2);
yValueCell = workbook.GetCell(worksheetIndex, 3, 2, 10);
series.DataPoints.AddDataPointForScatterSeries(xValueCell, yValueCell);
series.Type = ChartType.ScatterWithStraightLinesAndMarkers;
series.Marker.Size = 10;
series.Marker.Symbol = MarkerStyleType.Star;
series = chart.ChartData.Series[1];
xValueCell = workbook.GetCell(worksheetIndex, 2, 3, 5);
yValueCell = workbook.GetCell(worksheetIndex, 2, 4, 2);
series.DataPoints.AddDataPointForScatterSeries(xValueCell, yValueCell);
xValueCell = workbook.GetCell(worksheetIndex, 3, 3, 3);
yValueCell = workbook.GetCell(worksheetIndex, 3, 4, 1);
series.DataPoints.AddDataPointForScatterSeries(xValueCell, yValueCell);
xValueCell = workbook.GetCell(worksheetIndex, 4, 3, 2);
yValueCell = workbook.GetCell(worksheetIndex, 4, 4, 2);
series.DataPoints.AddDataPointForScatterSeries(xValueCell, yValueCell);
xValueCell = workbook.GetCell(worksheetIndex, 5, 3, 5);
yValueCell = workbook.GetCell(worksheetIndex, 5, 4, 1);
series.DataPoints.AddDataPointForScatterSeries(xValueCell, yValueCell);
series.Marker.Size = 10;
series.Marker.Symbol = MarkerStyleType.Circle;
presentation.Save("AsposeChart.pptx", SaveFormat.Pptx);
نتیجه:

ایجاد نمودارهای دایرهای
نمودارهای دایرهای بهترین استفاده را برای نشان دادن رابطهٔ بخش‑به‑کل در دادهها دارند، بهویژه زمانی که دادهها شامل برچسبهای ردهای با مقادیر عددی باشند. با این حال، اگر دادههای شما شامل تعداد زیادی بخش یا برچسب باشد، ممکن است بهتر باشد بهجای آن از نمودار میلهای استفاده کنید.
این مثال یک نمودار دایرهای با سه مقدار فصلی ایجاد میکند. هر قطعه دارای پر شدن و حاشیهٔ سفارشی است و برچسبها ترکیبیهای مختلفی از مقادیر، درصدها و اطلاعات سری را نشان میدهند. ویژگی FirstSliceAngle اولین قطعه را در زاویهٔ ۱۸۰ درجه آغاز میکند.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Pie, 20, 20, 500, 300);
chart.ChartTitle.AddTextFrameForOverriding("Sample Title");
chart.ChartTitle.TextFrameForOverriding.TextFrameFormat.CenterText = NullableBool.True;
chart.ChartTitle.Height = 20;
chart.HasTitle = true;
chart.ChartData.Series[0].Labels.DefaultDataLabelFormat.ShowValue = true;
var workbook = chart.ChartData.ChartDataWorkbook;
var worksheetIndex = 0;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var categoryCell = workbook.GetCell(0, 1, 0, "1st Qtr");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, 2, 0, "2nd Qtr");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, 3, 0, "3rd Qtr");
chart.ChartData.Categories.Add(categoryCell);
var seriesNameCell = workbook.GetCell(0, 0, 1, "Series 1");
var series = chart.ChartData.Series.Add(seriesNameCell, chart.Type);
var valueCell = workbook.GetCell(worksheetIndex, 1, 1, 20);
series.DataPoints.AddDataPointForPieSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 1, 50);
series.DataPoints.AddDataPointForPieSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 1, 30);
series.DataPoints.AddDataPointForPieSeries(valueCell);
chart.ChartData.SeriesGroups[0].IsColorVaried = true;
var firstSlice = series.DataPoints[0];
firstSlice.Format.Fill.FillType = FillType.Solid;
firstSlice.Format.Fill.SolidFillColor.Color = Color.Cyan;
firstSlice.Format.Line.FillFormat.FillType = FillType.Solid;
firstSlice.Format.Line.FillFormat.SolidFillColor.Color = Color.Gray;
firstSlice.Format.Line.Width = 3.0;
firstSlice.Format.Line.Style = LineStyle.ThinThick;
firstSlice.Format.Line.DashStyle = LineDashStyle.LargeDash;
var secondSlice = series.DataPoints[1];
secondSlice.Format.Fill.FillType = FillType.Solid;
secondSlice.Format.Fill.SolidFillColor.Color = Color.Brown;
secondSlice.Format.Line.FillFormat.FillType = FillType.Solid;
secondSlice.Format.Line.FillFormat.SolidFillColor.Color = Color.Blue;
secondSlice.Format.Line.Width = 3.0;
secondSlice.Format.Line.Style = LineStyle.Single;
secondSlice.Format.Line.DashStyle = LineDashStyle.LargeDashDot;
var thirdSlice = series.DataPoints[2];
thirdSlice.Format.Fill.FillType = FillType.Solid;
thirdSlice.Format.Fill.SolidFillColor.Color = Color.Coral;
thirdSlice.Format.Line.FillFormat.FillType = FillType.Solid;
thirdSlice.Format.Line.FillFormat.SolidFillColor.Color = Color.Red;
thirdSlice.Format.Line.Width = 2.0;
thirdSlice.Format.Line.Style = LineStyle.ThinThin;
thirdSlice.Format.Line.DashStyle = LineDashStyle.LargeDashDotDot;
var firstLabel = series.DataPoints[0].Label;
firstLabel.DataLabelFormat.ShowValue = true;
var secondLabel = series.DataPoints[1].Label;
secondLabel.DataLabelFormat.ShowValue = true;
secondLabel.DataLabelFormat.ShowLegendKey = true;
secondLabel.DataLabelFormat.ShowPercentage = true;
var thirdLabel = series.DataPoints[2].Label;
thirdLabel.DataLabelFormat.ShowSeriesName = true;
thirdLabel.DataLabelFormat.ShowPercentage = true;
series.Labels.DefaultDataLabelFormat.ShowLeaderLines = true;
chart.ChartData.SeriesGroups[0].FirstSliceAngle = 180;
presentation.Save("PieChart.pptx", SaveFormat.Pptx);
نتیجه:

برای بهبود خوانایی برچسبهای خارج از دایره، به Format Leader Lines مراجعه کنید تا مثال موقعیتدهی برچسبها و سفارشیسازی رنگ، عرض، شفافیت و استایل خطها را ببینید.
ایجاد نمودارهای خطی
نمودارهای خطی (که بهعنوان نمودارهای line graph نیز شناخته میشوند) بهترین استفاده را در موقعیتهایی دارند که میخواهید تغییرات مقدار را در طول زمان نشان دهید. با استفاده از یک نمودار خطی میتوانید مقدار زیادی داده را بههمراه هم مقایسه کنید، تغییرات و روندها را در طول زمان دنبال کنید، ناهماهنگیها در سریهای داده را برجسته کنید و غیره.
این مثال از AddChart برای ایجاد یک نمودار خطی با سریها و دستههای پیشفرض استفاده میکند و سپس ارائه را بهصورت PPTX ذخیره میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var lineChart = slide.Shapes.AddChart(ChartType.Line, 20, 20, 500, 300);
presentation.Save("lineChart.pptx", SaveFormat.Pptx);
بهصورت پیشفرض، نقاط یک نمودار خطی با خطوط مستقیم متصل میشوند. اگر میخواهید نقاط بهجای خطوط مستقیم با خطوط نقطهدار متصل شوند، ویژگی DashStyle را به یک مقدار از LineDashStyle تنظیم کنید:
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var lineChart = slide.Shapes.AddChart(ChartType.Line, 20, 20, 500, 300);
foreach (var series in lineChart.ChartData.Series)
{
series.Format.Line.DashStyle = LineDashStyle.Dash;
}
نتیجه:

ایجاد نمودارهای درختی (Tree Map)
نمودارهای درختی بهترین استفاده را برای دادههای فروش دارند وقتی میخواهید اندازه نسبی دستههای داده را نشان دهید و بهسرعت به موارد بزرگسهم در هر دسته توجه کنید.
این مثال یک نمودار درختی با هشت برگ که در چهار ساقه و دو شاخه گروهبندی شدهاند، ایجاد میکند. متد SetGroupingItem ساقهها را در سطح گروهبندی ۱ و شاخهها را در سطح ۲ اختصاص میدهد. مقادیر اندازه مستطیلهای نسبی را تعیین میکند، در حالی که برچسبهای ردهای و برچسبهای والد همپوشانیشده سلسلهمراتب را شناسایی میکنند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Treemap, 20, 20, 500, 300);
chart.ChartData.Categories.Clear();
chart.ChartData.Series.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
// شاخه 1
var categoryCell = workbook.GetCell(0, "C1", "Leaf1");
var leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem1");
leaf.GroupingLevels.SetGroupingItem(2, "Branch1");
categoryCell = workbook.GetCell(0, "C2", "Leaf2");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "C3", "Leaf3");
leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem2");
categoryCell = workbook.GetCell(0, "C4", "Leaf4");
chart.ChartData.Categories.Add(categoryCell);
// شاخه 2
categoryCell = workbook.GetCell(0, "C5", "Leaf5");
leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem3");
leaf.GroupingLevels.SetGroupingItem(2, "Branch2");
categoryCell = workbook.GetCell(0, "C6", "Leaf6");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "C7", "Leaf7");
leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem4");
categoryCell = workbook.GetCell(0, "C8", "Leaf8");
chart.ChartData.Categories.Add(categoryCell);
var series = chart.ChartData.Series.Add(ChartType.Treemap);
series.Labels.DefaultDataLabelFormat.ShowCategoryName = true;
var valueCell = workbook.GetCell(0, "D1", 4);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D2", 5);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D3", 3);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D4", 6);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D5", 9);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D6", 9);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D7", 4);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
valueCell = workbook.GetCell(0, "D8", 3);
series.DataPoints.AddDataPointForTreemapSeries(valueCell);
series.ParentLabelLayout = ParentLabelLayoutType.Overlapping;
presentation.Save("Treemap.pptx", SaveFormat.Pptx);
نتیجه:

ایجاد نمودارهای آبشاری
یک نمودار آبشاری نشان میدهد که تغییرات مثبت و منفی چگونه به مقدار نهایی کمک میکنند. برای مثال، یک تجزیه سود میتواند با درآمد شروع شود، هزینهها را کم کند و سایر درآمدها را اضافه کند. ستونهای تغییر بین مقدار قبلی و مقدار جدید در حال حرکت هستند، در حالی که ستونهای مجموع از صفر تا مقدار انباشته شده گسترش مییابند.
مثال زیر از مقادیر به هزار دلار آمریکا استفاده میکند:
| رده | مقدار کتابکار | نوع ستون |
|---|---|---|
| درآمد | 1000 | افزایشی |
| هزینههای فروش | -400 | کاهشی |
| سود ناخالص | 600 | مجموع میانی |
| هزینههای عملیاتی | -200 | کاهشی |
| سایر درآمدها | 50 | افزایشی |
| سود خالص | 450 | مجموع نهایی |
برای علامتگذاری یک نقطه بهعنوان مجموع میانی یا نهایی، ویژگی SetAsTotal آن را به true تنظیم کنید. مقدار انباشتهٔ واقعی را در سلول کتابکار آن نقطه قرار دهید: 600 برای سود ناخالص (1000 - 400) و 450 برای سود خالص (600 - 200 + 50). این ویژگی ستون را بهعنوان مجموع علامت میزند؛ مقدار سلول را محاسبه یا پر نمیکند. از صفر بهعنوان جایگزین استفاده نکنید یا مقدار دیگری برای نقطهٔ مجموع فراهم نکنید. یک ستون مجموع فقط مقدار انباشته را نمایش میدهد بدون اینکه دوباره به مقدار جاری افزوده شود.
این مثال کامل C# یک نمودار را با عضو Waterfall از ChartType میسازد، دادههای پیشفرض را پاک میکند و کتابکار توکار را پر میکند. ایندکس کاربرگ 0 اولین کاربرگ را انتخاب میکند؛ ستون A شامل نامهای ردهای و ستون B شامل مقادیر است. هر سلول مقدار با AddDataPointForWaterfallSeries اضافه میشود. ایندکسهای صفر‑مبنا 2 و 5 به ترتیب مجموعهای میانی و نهایی را شناسایی میکند. فعالسازی ShowValue مقادیر را روی ستونها نشان میدهد. هیچ ارائه یا کتابکاری ورودی لازم نیست.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Waterfall, 20, 20, 680, 200);
chart.HasTitle = true;
chart.ChartTitle.AddTextFrameForOverriding("Profit breakdown (USD thousands)");
chart.ChartTitle.Overlay = false;
chart.HasLegend = false;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
var worksheetIndex = 0;
workbook.Clear(worksheetIndex);
var seriesNameCell = workbook.GetCell(worksheetIndex, 0, 1, "Profit");
var series = chart.ChartData.Series.Add(seriesNameCell, ChartType.Waterfall);
var categories = new[] { "Revenue", "Cost of sales", "Gross profit", "Operating expenses", "Other income", "Net profit" };
var values = new double[] { 1000, -400, 600, -200, 50, 450 };
for (var i = 0; i < categories.Length; i++)
{
var categoryCell = workbook.GetCell(worksheetIndex, i + 1, 0, categories[i]);
chart.ChartData.Categories.Add(categoryCell);
var valueCell = workbook.GetCell(worksheetIndex, i + 1, 1, values[i]);
series.DataPoints.AddDataPointForWaterfallSeries(valueCell);
}
// نقطههای سوم و ششم بهعنوان مجموعها نمایش داده میشوند، نه بهعنوان تغییرات اضافی.
series.DataPoints[2].SetAsTotal = true;
series.DataPoints[5].SetAsTotal = true;
series.ShowConnectorLines = true;
series.Labels.DefaultDataLabelFormat.ShowValue = true;
presentation.Save("WaterfallChart.pptx", SaveFormat.Pptx);
ویژگی سطح‑سری ShowConnectorLines را به true تنظیم کنید تا خطوطی که ستونهای متوالی را به هم وصل میکنند، نشان داده شوند و مقدار جاری راحتتر دنبال شود. برای پنهان کردن این خطوط، مقداردهی در مثال را قبل از ذخیرهسازی به series.ShowConnectorLines = false; تغییر دهید. این فقط دیداری بودن خط را تغییر میدهد، نه داده یا مجموعها.
ارائهٔ ذخیرهشده سود ناخالص ۶۰۰ و سود خالص ۴۵۰ را نشان میدهد، بهطوری که هر دو مجموع از صفر کشیده شدهاند:

ایجاد نمودارهای سهام
نمودارهای سهام برای نمایش دادههای مالی مانند قیمتهای باز، بالا، پایین و بسته استفاده میشوند و به تحلیل روندهای بازار و نوسانها کمک میکنند. این نمودارها بینشهای اساسی دربارهٔ عملکرد سهام ارائه میدهند و به سرمایهگذاران و تحلیلگران در اتخاذ تصمیمات آگاهانه یاری میرسانند.
این مثال یک نمودار open‑high‑low‑close با چهار سری به ترتیب و سه رده ایجاد میکند. ویژگی HasUpDownBars نوارهای بالا/پایین را فعال میکند و HiLowLinesFormat خطوط بالا‑پایین را که بازهٔ قیمتی را نشان میدهند، کنترل میکند، در حالی که خطوط سریهای فردی و خطوط شبکه افقی جزئی مخفی میشوند.
مدیر UpDownBars دو شیء UpBarsFormat و DownBarsFormat را افشا میکند. برای هر شیء، ویژگیهای Fill و Line را برای تنظیم پر شدن و حاشیه بهطور مستقل استفاده کنید. این مثال نوارهای سبز با حاشیههای سبز‑تیره برای بازههای صعودی و نوارهای نارنجی‑قرمز با حاشیههای قرمز‑تیره برای بازههای نزولی استفاده میکند.
برای هر رده مقادیر عددی برای تمام چهار سری فراهم کنید، بهطوری که High و Low، Open و Close را در بر بگیرد. نوارها Close را با Open در همان رده مقایسه میکنند، نه با ردهٔ قبلی: A از ۷۲ به ۲۵ سقوط میکند، در حالی که B از ۲۵ به ۳۸ صعود میکند و C از ۳۸ به ۵۰ صعود میکند. مقادیر برابر Open و Close باعث عدم نمایش بازهٔ پر شده میشود. نوارهای بالا/پایین بازهٔ Open‑Close را پوشش میدهند؛ خطوط بالا‑پایین بازهٔ Low‑High را پوشش میدهند. این نوارها به گروه سری تعلق دارند و سریهای معمول نمودار میلهای نیستند.
این قالببندی همچنین با نمودارهای Line and LineWithMarkers که حداقل دو سری در همان گروه و مقادیر عددی متناظر برای هر رده دارند، کار میکند. برای این نمودارهای خطی غیر‑پشتهای، نوارهای بالا/پایین سری اول و آخر را مقایسه میکنند: مقدار نهایی بالاتر یک نوار بالا، مقدار نهایی پایینتر یک نوار پایین ایجاد میکند. معکوس کردن این سریها طبقهبندی را معکوس میکند. مثال زیر از OpenHighLowClose استفاده میکند؛ فرض نکنید سایر انواع سهام، خط‑پشته یا ۳ بعدی همان ترتیب داده یا تفسیر بازه را دارند.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.OpenHighLowClose, 20, 20, 500, 150, false);
var workbook = chart.ChartData.ChartDataWorkbook;
var categoryCell = workbook.GetCell(0, 1, 0, "A");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, 2, 0, "B");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, 3, 0, "C");
chart.ChartData.Categories.Add(categoryCell);
var seriesNameCell = workbook.GetCell(0, 0, 1, "Open");
chart.ChartData.Series.Add(seriesNameCell, ChartType.OpenHighLowClose);
seriesNameCell = workbook.GetCell(0, 0, 2, "High");
chart.ChartData.Series.Add(seriesNameCell, ChartType.OpenHighLowClose);
seriesNameCell = workbook.GetCell(0, 0, 3, "Low");
chart.ChartData.Series.Add(seriesNameCell, ChartType.OpenHighLowClose);
seriesNameCell = workbook.GetCell(0, 0, 4, "Close");
chart.ChartData.Series.Add(seriesNameCell, ChartType.OpenHighLowClose);
var series = chart.ChartData.Series[0];
var valueCell = workbook.GetCell(0, 1, 1, 72);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 2, 1, 25);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 3, 1, 38);
series.DataPoints.AddDataPointForStockSeries(valueCell);
series = chart.ChartData.Series[1];
valueCell = workbook.GetCell(0, 1, 2, 172);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 2, 2, 57);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 3, 2, 57);
series.DataPoints.AddDataPointForStockSeries(valueCell);
series = chart.ChartData.Series[2];
valueCell = workbook.GetCell(0, 1, 3, 12);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 2, 3, 12);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 3, 3, 13);
series.DataPoints.AddDataPointForStockSeries(valueCell);
series = chart.ChartData.Series[3];
valueCell = workbook.GetCell(0, 1, 4, 25);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 2, 4, 38);
series.DataPoints.AddDataPointForStockSeries(valueCell);
valueCell = workbook.GetCell(0, 3, 4, 50);
series.DataPoints.AddDataPointForStockSeries(valueCell);
var upDownBars = chart.ChartData.SeriesGroups[0].UpDownBars;
upDownBars.HasUpDownBars = true;
upDownBars.UpBarsFormat.Fill.FillType = FillType.Solid;
upDownBars.UpBarsFormat.Fill.SolidFillColor.Color = Color.LimeGreen;
upDownBars.UpBarsFormat.Line.FillFormat.FillType = FillType.Solid;
upDownBars.UpBarsFormat.Line.FillFormat.SolidFillColor.Color = Color.DarkGreen;
upDownBars.UpBarsFormat.Line.Width = 2;
upDownBars.DownBarsFormat.Fill.FillType = FillType.Solid;
upDownBars.DownBarsFormat.Fill.SolidFillColor.Color = Color.OrangeRed;
upDownBars.DownBarsFormat.Line.FillFormat.FillType = FillType.Solid;
upDownBars.DownBarsFormat.Line.FillFormat.SolidFillColor.Color = Color.DarkRed;
upDownBars.DownBarsFormat.Line.Width = 2;
chart.ChartData.SeriesGroups[0].HiLowLinesFormat.Line.FillFormat.FillType = FillType.Solid;
foreach (var stockSeries in chart.ChartData.Series)
{
stockSeries.Format.Line.FillFormat.FillType = FillType.NoFill;
}
chart.Axes.VerticalAxis.MinorGridLinesFormat.Line.FillFormat.FillType = FillType.NoFill;
presentation.Save("Stock-chart.pptx", SaveFormat.Pptx);
نتیجه، استخراجشده از PowerPoint:

ایجاد نمودارهای جعبهای و ویسکر (Box and Whisker)
نمودارهای جعبهای و ویسکر برای نمایش توزیع دادهها با خلاصهسازی معیارهای آماری کلیدی مانند میانه، چارکها و نقاط پرت استفاده میشوند. این نمودارها بهویژه در تحلیل اکتشافی دادهها و مطالعات آماری برای درک سریع تغییرپذیری دادهها و شناسایی هر گونه ناهماهنگی مفید هستند.
این مثال یک نمودار جعبهای و ویسکر از شش مقدار ایجاد میکند. ویژگی QuartileMethod محاسبهٔ چارک اختصاصی را انتخاب میکند. مثال همچنین خطوط میانگین، نشانگرهای میانگین، نقاط داخلی و نقاط پرت را فعال میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.BoxAndWhisker, 20, 20, 500, 300);
chart.ChartData.Categories.Clear();
chart.ChartData.Series.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
var categoryCell = workbook.GetCell(0, "A1", "Category 1");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A2", "Category 2");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A3", "Category 3");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A4", "Category 4");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A5", "Category 5");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A6", "Category 6");
chart.ChartData.Categories.Add(categoryCell);
var series = chart.ChartData.Series.Add(ChartType.BoxAndWhisker);
series.QuartileMethod = QuartileMethodType.Exclusive;
series.ShowMeanLine = true;
series.ShowMeanMarkers = true;
series.ShowInnerPoints = true;
series.ShowOutlierPoints = true;
var valueCell = workbook.GetCell(0, "B1", 15);
series.DataPoints.AddDataPointForBoxAndWhiskerSeries(valueCell);
valueCell = workbook.GetCell(0, "B2", 41);
series.DataPoints.AddDataPointForBoxAndWhiskerSeries(valueCell);
valueCell = workbook.GetCell(0, "B3", 16);
series.DataPoints.AddDataPointForBoxAndWhiskerSeries(valueCell);
valueCell = workbook.GetCell(0, "B4", 10);
series.DataPoints.AddDataPointForBoxAndWhiskerSeries(valueCell);
valueCell = workbook.GetCell(0, "B5", 23);
series.DataPoints.AddDataPointForBoxAndWhiskerSeries(valueCell);
valueCell = workbook.GetCell(0, "B6", 16);
series.DataPoints.AddDataPointForBoxAndWhiskerSeries(valueCell);
presentation.Save("BoxAndWhisker.pptx", SaveFormat.Pptx);
ایجاد نمودارهای قیفی (Funnel)
نمودارهای قیفی برای بهصورت تصویری نشان دادن فرآیندهایی که شامل مرحلههای متوالی هستند، بهکار میروند؛ در اینجا حجم دادهها با پیشرفت از یک گام به گام دیگر کاهش مییابد. این نمودارها بهویژه برای تحلیل نرخ تبدیل، شناسایی گلوگاهها و پیگیری کارایی فرآیندهای فروش یا بازاریابی مفید هستند.
این مثال از AddChart برای افزودن یک نمودار قیفی به اسلاید اول یک ارائهٔ موجود استفاده میکند. دادههای پیشفرض را با شش رده و مقادیری بین ۵۰ تا ۵۰۰ جایگزین میکند و سپس ارائهٔ بهروزشده را ذخیره میکند. ارائه ورودی باید حداقل یک اسلاید داشته باشد.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation("test.pptx");
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Funnel, 50, 50, 500, 400);
chart.ChartData.Categories.Clear();
chart.ChartData.Series.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
var categoryCell = workbook.GetCell(0, "A1", "Category 1");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A2", "Category 2");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A3", "Category 3");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A4", "Category 4");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A5", "Category 5");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "A6", "Category 6");
chart.ChartData.Categories.Add(categoryCell);
var series = chart.ChartData.Series.Add(ChartType.Funnel);
var valueCell = workbook.GetCell(0, "B1", 50);
series.DataPoints.AddDataPointForFunnelSeries(valueCell);
valueCell = workbook.GetCell(0, "B2", 100);
series.DataPoints.AddDataPointForFunnelSeries(valueCell);
valueCell = workbook.GetCell(0, "B3", 200);
series.DataPoints.AddDataPointForFunnelSeries(valueCell);
valueCell = workbook.GetCell(0, "B4", 300);
series.DataPoints.AddDataPointForFunnelSeries(valueCell);
valueCell = workbook.GetCell(0, "B5", 400);
series.DataPoints.AddDataPointForFunnelSeries(valueCell);
valueCell = workbook.GetCell(0, "B6", 500);
series.DataPoints.AddDataPointForFunnelSeries(valueCell);
presentation.Save("Funnel.pptx", SaveFormat.Pptx);
نتیجه:

ایجاد نمودارهای خورشیدی (Sunburst)
نمودارهای خورشیدی برای بصریسازی دادههای سلسلهمراتبی استفاده میشوند؛ سطوح بهصورت حلقههای متحدالمرکز نمایش داده میشوند. این نمودارها بهوضوح روابط بخش‑به‑کل را نشان میدهند و برای نمایش دستهها و زیرمجموعههای تو در تو در قالبی واضح و فشرده ایدهآلاند.
این مثال یک نمودار خورشیدی با هشت برگ که در چهار ساقه و دو شاخه گروهبندی شدهاند، ایجاد میکند. متد SetGroupingItem ساقهها را در سطح گروهبندی ۱ و شاخهها را در سطح ۲ اختصاص میدهد. برچسبهای ردهای بخشها را شناسایی میکند و مقادیر اندازه نسبی آنها را تعیین میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Sunburst, 20, 20, 500, 300);
chart.ChartData.Categories.Clear();
chart.ChartData.Series.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
// شاخه 1
var categoryCell = workbook.GetCell(0, "C1", "Leaf1");
var leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem1");
leaf.GroupingLevels.SetGroupingItem(2, "Branch1");
categoryCell = workbook.GetCell(0, "C2", "Leaf2");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "C3", "Leaf3");
leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem2");
categoryCell = workbook.GetCell(0, "C4", "Leaf4");
chart.ChartData.Categories.Add(categoryCell);
// شاخه 2
categoryCell = workbook.GetCell(0, "C5", "Leaf5");
leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem3");
leaf.GroupingLevels.SetGroupingItem(2, "Branch2");
categoryCell = workbook.GetCell(0, "C6", "Leaf6");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "C7", "Leaf7");
leaf = chart.ChartData.Categories.Add(categoryCell);
leaf.GroupingLevels.SetGroupingItem(1, "Stem4");
categoryCell = workbook.GetCell(0, "C8", "Leaf8");
chart.ChartData.Categories.Add(categoryCell);
var series = chart.ChartData.Series.Add(ChartType.Sunburst);
series.Labels.DefaultDataLabelFormat.ShowCategoryName = true;
var valueCell = workbook.GetCell(0, "D1", 4);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D2", 5);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D3", 3);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D4", 6);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D5", 9);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D6", 9);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D7", 4);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
valueCell = workbook.GetCell(0, "D8", 3);
series.DataPoints.AddDataPointForSunburstSeries(valueCell);
presentation.Save("Sunburst.pptx", SaveFormat.Pptx);
نتیجه:

ایجاد نمودارهای هیستوگرام
نمودارهای هیستوگرام نشان میدهند که مقادیر عددی چگونه در بازههای (باینها) مختلف توزیع شدهاند. برای گزارشهای ماهانهٔ زمان پردازش سفارشات، از عرض باین ثابت و آستانههای ثابت استفاده کنید تا بازهها سازگار بمانند و مقایسه توزیعها سادهتر شود.
محور افقی را با AggregationType به حالت از AxisAggregationType تنظیم کنید. BinWidth فقط برای ByBinWidth اعمال میشود؛ NumberOfBins فقط برای ByNumberOfBins کاربرد دارد. از Automatic برای اجازه به نمودار در انتخاب باینها استفاده کنید.
استفاده از عرض باین ثابت
این مثال زمانهای پردازش را به بازههای ۱۰ دقیقهای گروهبندی میکند؛ باینهای جداگانهای برای زمانهای ≤ ۱۰ دقیقه و > ۴۰ دقیقه وجود دارد. این باینها را با IsUnderflowBin و IsOverflowBin فعال کنید. هنگام ارائهٔ آستانههای صریح برای UnderflowBin و OverflowBin، ویژگیهای IsAutomaticUnderflowBin و IsAutomaticOverflowBin را به false تنظیم کنید.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Histogram, 20, 20, 680, 200);
chart.HasLegend = false;
chart.HasTitle = false;
chart.ChartData.Categories.Clear();
chart.ChartData.Series.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
var series = chart.ChartData.Series.Add(ChartType.Histogram);
double[] values = { 5, 10, 10, 11, 15, 20, 20, 21, 25, 30, 30, 31, 35, 40, 40, 41, 50 };
for (var i = 0; i < values.Length; i++)
{
var valueCell = workbook.GetCell(0, i, 0, values[i]);
series.DataPoints.AddDataPointForHistogramSeries(valueCell);
}
var axis = chart.Axes.HorizontalAxis;
axis.AggregationType = AxisAggregationType.ByBinWidth;
axis.BinWidth = 10;
axis.IsUnderflowBin = true;
axis.IsAutomaticUnderflowBin = false;
axis.UnderflowBin = 10;
axis.IsOverflowBin = true;
axis.IsAutomaticOverflowBin = false;
axis.OverflowBin = 40;
presentation.Save("Histogram-bin-width.pptx", SaveFormat.Pptx);
ارائه در PowerPoint تعداد باینهای ۳، ۴، ۴، ۴، و ۲ را نشان میدهد. باین زیرحجم شامل 5, 10, 10 است، بنابراین آستانهاش شامل است. باین فوقحجم فقط 41, 50 را شامل میشود، بنابراین آستانهاش خارج است؛ هر دو مقدار برابر 40 در بازهٔ قبلی میمانند. باینهای داخلی شامل مقادیر بزرگتر از حد پایین و کوچکتر یا مساوی حد بالای خود هستند.

مشخص کردن تعداد باینها
برای داشتن سطح جزئیات ثابت بهجای بازههای ثابت، برای همان دادهها پنج باین درخواست کنید. این مثال باینهای زیرحجم و فوقحجم را غیرفعال میگذارد. نمودار عرض را از بازهٔ دادهها محاسبه میکند، بنابراین مرزها میتوانند بین گزارشها تغییر کنند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Histogram, 20, 20, 680, 200);
chart.HasLegend = false;
chart.HasTitle = false;
chart.ChartData.Categories.Clear();
chart.ChartData.Series.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
var series = chart.ChartData.Series.Add(ChartType.Histogram);
double[] values = { 5, 10, 10, 11, 15, 20, 20, 21, 25, 30, 30, 31, 35, 40, 40, 41, 50 };
for (var i = 0; i < values.Length; i++)
{
var valueCell = workbook.GetCell(0, i, 0, values[i]);
series.DataPoints.AddDataPointForHistogramSeries(valueCell);
}
var axis = chart.Axes.HorizontalAxis;
axis.AggregationType = AxisAggregationType.ByNumberOfBins;
axis.NumberOfBins = 5;
presentation.Save("Histogram-bin-count.pptx", SaveFormat.Pptx);
پنج باین دارای شمارش ۴، ۴، ۴، ۴ و ۱ هستند. این توزیع را با نتیجهٔ عرض ثابت بالا مقایسه کنید: مقادیر ورودی یکسانند، اما مرزها متفاوتاند.

ایجاد نمودارهای راداری
نمودارهای راداری برای نمایش دادههای چندمتغیره در قالب دو‑بعدی استفاده میشوند و امکان مقایسهٔ همزمان چندین متغیر را فراهم میکنند. این نمودارها بهویژه برای شناسایی الگوها، قوتها و ضعفها در چندین معیار عملکرد یا ویژگی مفید هستند.
این مثال از AddChart برای ایجاد یک نمودار راداری با سریها و ردههای پیشفرض استفاده میکند و سپس ارائه را بهصورت PPTX ذخیره میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
slide.Shapes.AddChart(ChartType.Radar, 20, 20, 500, 300);
presentation.Save("Radar-chart.pptx", SaveFormat.Pptx);
نتیجه:

ایجاد نمودارهای چند‑ردهای
نمودارهای چند‑ردهای برای نمایش دادههایی استفاده میشوند که شامل بیش از یک گروهبندی ردهای هستند و به شما امکان مقایسهٔ مقادیر در ابعاد چندگانه را میدهند. این نمودارها بهویژه زمانی که نیاز به تحلیل روندها و روابط داخل مجموعههای دادهٔ چندلایهٔ پیچیده دارید، مفیدند.
این مثال یک نمودار ستونی خوشهای با هشت رده که در چهار جفت تنظیم شدهاند، ایجاد میکند. متد SetGroupingItem به هر جفت برچسب مشترکی در سطح گروهبندی ۱ میدهد و محوری ردهای با برچسبهای فردی و گروهی تولید میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 300);
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
var worksheetIndex = 0;
var categoryCell = workbook.GetCell(0, "c2", "A");
var category = chart.ChartData.Categories.Add(categoryCell);
category.GroupingLevels.SetGroupingItem(1, "Group1");
categoryCell = workbook.GetCell(0, "c3", "B");
category = chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "c4", "C");
category = chart.ChartData.Categories.Add(categoryCell);
category.GroupingLevels.SetGroupingItem(1, "Group2");
categoryCell = workbook.GetCell(0, "c5", "D");
category = chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "c6", "E");
category = chart.ChartData.Categories.Add(categoryCell);
category.GroupingLevels.SetGroupingItem(1, "Group3");
categoryCell = workbook.GetCell(0, "c7", "F");
category = chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(0, "c8", "G");
category = chart.ChartData.Categories.Add(categoryCell);
category.GroupingLevels.SetGroupingItem(1, "Group4");
categoryCell = workbook.GetCell(0, "c9", "H");
category = chart.ChartData.Categories.Add(categoryCell);
var seriesNameCell = workbook.GetCell(0, "D1", "Series 1");
var series = chart.ChartData.Series.Add(seriesNameCell, ChartType.ClusteredColumn);
var valueCell = workbook.GetCell(worksheetIndex, "D2", 10);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D3", 20);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D4", 30);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D5", 40);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D6", 50);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D7", 60);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D8", 70);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, "D9", 80);
series.DataPoints.AddDataPointForBarSeries(valueCell);
presentation.Save("AsposeChart.pptx", SaveFormat.Pptx);
نتیجه:

حذف برچسب یک ربع
فایل quarters.pptx را دانلود کنید و در پوشهٔ کاری قرار دهید. نمودار آن نه ماه و یک سری فروش با مقادیر ۱۰ تا ۱۸ را نشان میدهد. محور رده سه برچسب ربع دارد: Q1 شامل Jan‑Mar، Q2 شامل Apr‑Jun و Q3 شامل Jul‑Sep است.
آوریل ردهٔ چهارم و ردهای است که بر روی آن Q2 بهصورت صریح تنظیم شده بود. روی مجموعهٔ GroupingLevels آوریل متد DeleteGroupingItem را صدا بزنید. سطح نسبت به آوریل است: سطح ۱ ربع آن و سطح ۰ خود ماه است. این متد نمیتواند ردهٔ برگ در سطح ۰ را حذف کند.
using System;
using System.Linq;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using (var presentation = new Presentation("quarters.pptx"))
{
var chart = (IChart)presentation.Slides[0].Shapes[0];
var april = chart.ChartData.Categories[3];
april.GroupingLevels.DeleteGroupingItem(1);
presentation.Save("quarters-updated.pptx", SaveFormat.Pptx);
}
using var reopened = new Presentation("quarters-updated.pptx");
var updatedChart = (IChart)reopened.Slides[0].Shapes[0];
var data = updatedChart.ChartData;
Console.WriteLine(string.Join(", ", data.Categories.Select(month => month.AsCell.Value)));
Console.WriteLine(string.Join(", ", data.Series[0].DataPoints.Select(point => point.Value.Data)));
نمودار بازگشایی شده ماههای اصلی (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep) و مقادیر فروش (10, 11, 12, 13, 14, 15, 16, 17, 18) را به همان ترتیب چاپ میکند. فایل quarters-updated.pptx را در PowerPoint باز کنید تا برچسبهای محور را مقایسه کنید. برچسب Q2 و مرز گروه قبل از آوریل ناپدید میشوند، بنابراین Q1 از ژانویه تا ژوئن میگیرد. Q3 همچنان از جولای آغاز میشود.

ایجاد نمودارهای نقشهای
نمودارهای نقشهای برای بصریسازی دادههای جغرافیایی با نگاشت اطلاعات به مکانهای خاص مانند کشورها، ایالات یا شهرها استفاده میشوند. این نمودارها برای تحلیل روندهای منطقهای، دادههای جمعیتی و توزیعهای فضایی بهصورت واضح و جذاب بسیار مفیدند.
این مثال از AddChart برای ایجاد یک نمودار نقشهای با دادههای جغرافیایی پیشفرض استفاده میکند و آن را برای مشاهده در PowerPoint ذخیره میکند.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Map, 20, 20, 500, 300);
presentation.Save("mapChart.pptx", SaveFormat.Pptx);
نتیجه:

توجه
تصویر بالا نمایشگر ارائهٔ ذخیرهشدهای است که در PowerPoint باز شده. Aspose.Slides نمودار نقشهای و دادههای آن را بهدرستی مینویسد، اما خود آن نمودارهای نقشهای را رسم نمیکند: هنگامی که اسلایدی که شامل یک نمودار نقشهای است به تصویر تبدیل یا به PDF یا SVG تبدیل میشود، ناحیهٔ نمودار خالی میماند. سایر شکلها در همان اسلاید تحت تاثیر این موضوع قرار نمیگیرند.ایجاد نمودارهای ترکیبی
یک نمودار ترکیبی (یا combo chart) دو یا چند نوع نمودار را در یک گراف ترکیب میکند. این نمودار به شما امکان میدهد تا تفاوتها یا شباهتهای بین دو یا چند مجموعه داده را برجسته، مقایسه یا بررسی کنید و روابط بین آنها را شناسایی نمایید.

این مثال دو سری ستونی خوشهای را با یک سری خطی در چهار رده ترکیب میکند. ستونها از محور عمودی اولیه استفاده میکنند، در حالی که PlotOnSecondAxis خط را بر روی محور عمودی ثانویه (سمت راست) قرار میدهد. توابع کمکی عنوان، لیژن، برچسبهای محورها و خطوط شبکه را پیکربندی میکنند.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
CreateComboChart();
static void CreateComboChart()
{
using var presentation = new Presentation();
var chart = CreateChartWithFirstSeries(presentation.Slides[0]);
AddSecondSeriesToChart(chart);
AddThirdSeriesToChart(chart);
SetPrimaryAxesFormat(chart);
SetSecondaryAxesFormat(chart);
presentation.Save("combo-chart.pptx", SaveFormat.Pptx);
}
static IChart CreateChartWithFirstSeries(ISlide slide)
{
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
chart.HasTitle = true;
chart.ChartTitle.AddTextFrameForOverriding("Chart Title");
chart.ChartTitle.Overlay = false;
var portionFormat = chart.ChartTitle.TextFrameForOverriding.Paragraphs[0].ParagraphFormat.DefaultPortionFormat;
portionFormat.FontBold = NullableBool.False;
portionFormat.FontHeight = 18f;
chart.Legend.Position = LegendPositionType.Bottom;
chart.Legend.TextFormat.PortionFormat.FontHeight = 12f;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
var worksheetIndex = 0;
var categoryCell = workbook.GetCell(worksheetIndex, 1, 0, "Category 1");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(worksheetIndex, 2, 0, "Category 2");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(worksheetIndex, 3, 0, "Category 3");
chart.ChartData.Categories.Add(categoryCell);
categoryCell = workbook.GetCell(worksheetIndex, 4, 0, "Category 4");
chart.ChartData.Categories.Add(categoryCell);
var seriesNameCell = workbook.GetCell(worksheetIndex, 0, 1, "Series 1");
var series = chart.ChartData.Series.Add(seriesNameCell, chart.Type);
series.ParentSeriesGroup.Overlap = -25;
series.ParentSeriesGroup.GapWidth = 220;
var valueCell = workbook.GetCell(worksheetIndex, 1, 1, 4.3);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 1, 2.5);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 1, 3.5);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 4, 1, 4.5);
series.DataPoints.AddDataPointForBarSeries(valueCell);
return chart;
}
static void AddSecondSeriesToChart(IChart chart)
{
var workbook = chart.ChartData.ChartDataWorkbook;
const int worksheetIndex = 0;
var seriesNameCell = workbook.GetCell(worksheetIndex, 0, 2, "Series 2");
var series = chart.ChartData.Series.Add(seriesNameCell, ChartType.ClusteredColumn);
series.ParentSeriesGroup.Overlap = -25;
series.ParentSeriesGroup.GapWidth = 220;
var valueCell = workbook.GetCell(worksheetIndex, 1, 2, 2.4);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 2, 4.4);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 2, 1.8);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 4, 2, 2.8);
series.DataPoints.AddDataPointForBarSeries(valueCell);
}
static void AddThirdSeriesToChart(IChart chart)
{
var workbook = chart.ChartData.ChartDataWorkbook;
const int worksheetIndex = 0;
var seriesNameCell = workbook.GetCell(worksheetIndex, 0, 3, "Series 3");
var series = chart.ChartData.Series.Add(seriesNameCell, ChartType.Line);
var valueCell = workbook.GetCell(worksheetIndex, 1, 3, 2.0);
series.DataPoints.AddDataPointForLineSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 3, 2.0);
series.DataPoints.AddDataPointForLineSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 3, 3.0);
series.DataPoints.AddDataPointForLineSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 4, 3, 5.0);
series.DataPoints.AddDataPointForLineSeries(valueCell);
series.PlotOnSecondAxis = true;
}
static void SetPrimaryAxesFormat(IChart chart)
{
var horizontalAxis = chart.Axes.HorizontalAxis;
horizontalAxis.TextFormat.PortionFormat.FontHeight = 12f;
horizontalAxis.Format.Line.FillFormat.FillType = FillType.NoFill;
SetAxisTitle(horizontalAxis, "X Axis");
var verticalAxis = chart.Axes.VerticalAxis;
verticalAxis.TextFormat.PortionFormat.FontHeight = 12f;
verticalAxis.Format.Line.FillFormat.FillType = FillType.NoFill;
SetAxisTitle(verticalAxis, "Y Axis 1");
var majorGridLinesFormat = verticalAxis.MajorGridLinesFormat.Line.FillFormat;
majorGridLinesFormat.FillType = FillType.Solid;
majorGridLinesFormat.SolidFillColor.Color = Color.FromArgb(217, 217, 217);
}
static void SetSecondaryAxesFormat(IChart chart)
{
var secondaryHorizontalAxis = chart.Axes.SecondaryHorizontalAxis;
secondaryHorizontalAxis.Position = AxisPositionType.Bottom;
secondaryHorizontalAxis.CrossType = CrossesType.Maximum;
secondaryHorizontalAxis.IsVisible = false;
secondaryHorizontalAxis.MajorGridLinesFormat.Line.FillFormat.FillType = FillType.NoFill;
secondaryHorizontalAxis.MinorGridLinesFormat.Line.FillFormat.FillType = FillType.NoFill;
var secondaryVerticalAxis = chart.Axes.SecondaryVerticalAxis;
secondaryVerticalAxis.Position = AxisPositionType.Right;
secondaryVerticalAxis.TextFormat.PortionFormat.FontHeight = 12f;
secondaryVerticalAxis.Format.Line.FillFormat.FillType = FillType.NoFill;
secondaryVerticalAxis.MajorGridLinesFormat.Line.FillFormat.FillType = FillType.NoFill;
secondaryVerticalAxis.MinorGridLinesFormat.Line.FillFormat.FillType = FillType.NoFill;
SetAxisTitle(secondaryVerticalAxis, "Y Axis 2");
}
static void SetAxisTitle(IAxis axis, string axisTitle)
{
axis.HasTitle = true;
axis.Title.Overlay = false;
var titlePortionFormat = axis.Title.AddTextFrameForOverriding(axisTitle).Paragraphs[0].ParagraphFormat.DefaultPortionFormat;
titlePortionFormat.FontBold = NullableBool.False;
titlePortionFormat.FontHeight = 12f;
}
بهروزرسانی نمودارها
Aspose.Slides برای .NET به شما امکان میدهد تا نمودارهای PowerPoint را با اصلاح دادههای نمودار، قالببندی و استایل بهروزرسانی کنید. این قابلیت فرآیند نگهداری ارائهها را با محتوای دینامیک ساده میسازد و اطمینان میدهد که نمودارها بهدقت دادهها و استانداردهای بصری فعلی را منعکس میکنند.
این مثال نمودار با نام «My chart» را در اسلاید اول یک ارائهٔ موجود بهروزرسانی میکند. دو سری ستونی با سه نقطه دادهٔ هر کدام نیاز دارند، بهطوری که برچسبهای رده در ستون A و نامهای سری در ردیف اول اولین کاربرگ هستند. مثال از GetCell برای تغییر سلولهای کتابکار استفاده میکند، مقادیر سریها را بهروز میکند، سری سوم را اضافه میکند و نمودار را از طریق Type به استوانههای خوشهای تغییر میدهد.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
const string chartName = "My chart";
using var presentation = new Presentation("ExistingChart.pptx");
var slide = presentation.Slides[0];
foreach (IShape shape in slide.Shapes)
{
if (shape is IChart chart && chart.Name == chartName)
{
var worksheetIndex = 0;
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.GetCell(worksheetIndex, 1, 0, "Modified Category 1");
workbook.GetCell(worksheetIndex, 2, 0, "Modified Category 2");
var series = chart.ChartData.Series[0];
workbook.GetCell(worksheetIndex, 0, 1, "New_Series 1");
series.DataPoints[0].Value.Data = 90;
series.DataPoints[1].Value.Data = 123;
series.DataPoints[2].Value.Data = 44;
series = chart.ChartData.Series[1];
workbook.GetCell(worksheetIndex, 0, 2, "New_Series 2");
series.DataPoints[0].Value.Data = 23;
series.DataPoints[1].Value.Data = 67;
series.DataPoints[2].Value.Data = 99;
var seriesNameCell = workbook.GetCell(worksheetIndex, 0, 3, "Series 3");
series = chart.ChartData.Series.Add(seriesNameCell, chart.Type);
var valueCell = workbook.GetCell(worksheetIndex, 1, 3, 20);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 2, 3, 50);
series.DataPoints.AddDataPointForBarSeries(valueCell);
valueCell = workbook.GetCell(worksheetIndex, 3, 3, 30);
series.DataPoints.AddDataPointForBarSeries(valueCell);
chart.Type = ChartType.ClusteredCylinder;
}
}
presentation.Save("AsposeChartModified.pptx", SaveFormat.Pptx);
تنظیم بازهٔ داده برای یک نمودار
برای بررسی بازهای که قبلاً توسط یک نمودار موجود استفاده شده است، به Retrieve a Chart’s Data Range مراجعه کنید.
Aspose.Slides برای .NET انعطافپذیری تعریف یک بازهٔ دادهٔ خاص از یک کاربرگ بهعنوان منبع برای دادههای نمودار شما را فراهم میکند. این بدان معناست که میتوانید مستقیماً بخشی از کاربرگ خود را به نمودار نگاشت کنید و کنترل کنید کدام سلولها به سریها و ردههای نمودار کمک میکنند. بهاینسان میتوانید بهراحتی نمودارهای خود را با آخرین تغییرات داده در کاربرگ همگامسازی کنید و اطمینان حاصل کنید که ارائههای PowerPoint شما اطلاعات بهروز و دقیقی را منعکس میکنند.
این مثال از SetRange برای تنظیم منبع دادهٔ نمودار با نام «My chart» در اسلاید اول یک ارائهٔ موجود به Sheet1!A1:B4 استفاده میکند. کتابکار نمودار باید آن کاربرگ و بازهٔ پرشدهای که در ردیف اول سرعنوان سری، برچسبهای رده در ستون A و سه مقدار در ستون B داشته باشد، داشته باشد.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
const string chartName = "My chart";
using var presentation = new Presentation("ExistingChart.pptx");
var slide = presentation.Slides[0];
foreach (IShape shape in slide.Shapes)
{
if (shape is IChart chart && chart.Name == chartName)
{
chart.ChartData.SetRange("Sheet1!A1:B4");
}
}
presentation.Save("SetDataRange.pptx", SaveFormat.Pptx);
استفاده از نشانگرهای پیشفرض در نمودارها
هنگام استفاده از نشانگرهای پیشفرض در نمودارها، هر سری نمودار بهصورت خودکار یک نماد نشانگر پیشفرض متفاوت دریافت میکند.
این مثال از AddChart برای ایجاد یک نمودار با دو سری خطی و یک لیژن استفاده میکند. تنظیمات Marker نمادهای نشانگر اختصاص دادهشده بهصورت خودکار را حفظ میکند. سری اول شامل یک مقدار منفی و یک مقدار گمشده (که با null نشان داده میشود) است، در حالی که سری دوم برای هر رده یک مقدار دارد.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.LineWithMarkers, 10, 10, 400, 400);
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
var seriesNameCell = workbook.GetCell(0, 0, 1, "Series 1");
var series = chart.ChartData.Series.Add(seriesNameCell, chart.Type);
var categoryCell = workbook.GetCell(0, 1, 0, "C1");
chart.ChartData.Categories.Add(categoryCell);
var valueCell = workbook.GetCell(0, 1, 1, 24);
series.DataPoints.AddDataPointForLineSeries(valueCell);
categoryCell = workbook.GetCell(0, 2, 0, "C2");
chart.ChartData.Categories.Add(categoryCell);
valueCell = workbook.GetCell(0, 2, 1, 23);
series.DataPoints.AddDataPointForLineSeries(valueCell);
categoryCell = workbook.GetCell(0, 3, 0, "C3");
chart.ChartData.Categories.Add(categoryCell);
valueCell = workbook.GetCell(0, 3, 1, -10);
series.DataPoints.AddDataPointForLineSeries(valueCell);
categoryCell = workbook.GetCell(0, 4, 0, "C4");
chart.ChartData.Categories.Add(categoryCell);
valueCell = workbook.GetCell(0, 4, 1, null);
series.DataPoints.AddDataPointForLineSeries(valueCell);
seriesNameCell = workbook.GetCell(0, 0, 2, "Series 2");
var secondSeries = chart.ChartData.Series.Add(seriesNameCell, chart.Type);
valueCell = workbook.GetCell(0, 1, 2, 30);
secondSeries.DataPoints.AddDataPointForLineSeries(valueCell);
valueCell = workbook.GetCell(0, 2, 2, 10);
secondSeries.DataPoints.AddDataPointForLineSeries(valueCell);
valueCell = workbook.GetCell(0, 3, 2, 60);
secondSeries.DataPoints.AddDataPointForLineSeries(valueCell);
valueCell = workbook.GetCell(0, 4, 2, 40);
secondSeries.DataPoints.AddDataPointForLineSeries(valueCell);
chart.HasLegend = true;
chart.Legend.Overlay = false;
presentation.Save("DefaultMarkersInChart.pptx", SaveFormat.Pptx);
پرسشهای متداول
کدام انواع نمودارها توسط Aspose.Slides برای .NET پشتیبانی میشوند؟
Aspose.Slides برای .NET دامنهٔ وسیعی از انواع نمودارها از جمله میلهای، خطی، دایرهای، مساحتی، پراکندگی، هیستوگرام، رادار و بسیاری دیگر را پشتیبانی میکند. این انعطافپذیری به شما اجازه میدهد تا مناسبترین نوع نمودار را برای نیازهای تصویری دادههایتان انتخاب کنید.
چگونه یک نمودار جدید را به اسلاید اضافه کنم؟
برای افزودن یک نمودار، ابتدا یک نمونه از کلاس Presentation ایجاد کنید، اسلاید موردنظر را با ایندکساش دریافت کنید و سپس متد افزودن نمودار را صدا بزنید، نوع نمودار و دادههای اولیه را مشخص کنید. این فرآیند نمودار را مستقیماً به ارائهٔ شما ادغام میکند.
چگونه میتوان دادههای نمایشدادهشده در یک نمودار را بهروزرسانی کرد؟
میتوانید دادههای یک نمودار را با دسترسی به کتابکار دادهٔ آن (IChartDataWorkbook)، پاکسازی هر سری و ردهٔ پیشفرض، و سپس افزودن دادههای سفارشی خود بهروزرسانی کنید. این کار بهصورت برنامهنویسی نمودار را برای بازتاب جدیدترین دادهها تازه میکند.
آیا میتوان ظاهر نمودار را سفارشیسازی کرد؟
بله، Aspose.Slides برای .NET گزینههای سفارشیسازی گستردهای ارائه میدهد. میتوانید رنگها، قلمها، برچسبها، لیژنها و سایر عناصر قالببندی را تغییر دهید تا ظاهر نمودار را مطابق با نیازهای طراحی خاص خود تنظیم کنید.
ویژگی مرتبط: Create editable charts.