ChartSeriesCollection

ChartSeriesCollection class

يمثل مجموعة منChartSeries .

لمعرفة المزيد، قم بزيارةالعمل مع الرسوم البيانية مقالة توثيقية.

public class ChartSeriesCollection : IEnumerable<ChartSeries>

الخصائص

اسموصف
Count { get; }إرجاع عددChartSeries في هذه المجموعة.
Item { get; }يعيدChartSeries عند الفهرس المحدد.

طُرق

اسموصف
Add(string, double[])يضيف جديدChartSeries إلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة إلى مخططات الهيستوغرام.
Add(string, ChartMultilevelValue[], double[])يضيف جديدChartSeriesإلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة تحتوي على فئات بيانات متعددة المستويات.
Add(string, DateTime[], double[])يضيف جديدChartSeries إلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة إلى أي نوع من المخططات المساحية والرادارية والأسهم.
Add(string, double[], double[])يضيف جديدChartSeries إلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة إلى أي نوع من مخططات التشتت.
Add(string, string[], double[])يضيف جديدChartSeries إلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة إلى أي نوع من المخططات الشريطية والعمودية والخطية والسطحية.
Add(string, double[], double[], double[])يضيف جديدChartSeries إلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة إلى أي نوع من مخططات الفقاعات.
Add(string, string[], double[], bool[])يضيف جديدChartSeries إلى هذه المجموعة. استخدم هذه الطريقة لإضافة سلسلة إلى مخططات الشلال.
Clear()يزيل الكلChartSeries من هذه المجموعة.
GetEnumerator()يعيد كائن المعداد.
RemoveAt(int)يزيلChartSeries عند الفهرس المحدد.

أمثلة

يوضح كيفية إضافة بيانات السلسلة وإزالتها في مخطط.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// قم بإدراج مخطط عمودي يحتوي على ثلاث سلاسل من البيانات التجريبية بشكل افتراضي.
Shape chartShape = builder.InsertChart(ChartType.Column, 400, 300);
Chart chart = chartShape.Chart;

// تحتوي كل سلسلة على أربع قيم عشرية: واحدة لكل فئة من الفئات الأربع.
//ستمثل أربع مجموعات من ثلاثة أعمدة هذه البيانات.
ChartSeriesCollection chartData = chart.Series;

Assert.AreEqual(3, chartData.Count);

// اطبع اسم كل سلسلة في الرسم البياني.
using (IEnumerator<ChartSeries> enumerator = chart.Series.GetEnumerator())
{
    while (enumerator.MoveNext())
    {
        Console.WriteLine(enumerator.Current.Name);
    }
}

//هذه هي أسماء الفئات الموجودة في الرسم البياني.
string[] categories = { "Category 1", "Category 2", "Category 3", "Category 4" };

//يمكننا إضافة سلسلة بقيم جديدة للفئات الموجودة.
// سيحتوي هذا الرسم البياني الآن على أربع مجموعات مكونة من أربعة أعمدة.
chart.Series.Add("Series 4", categories, new[] { 4.4, 7.0, 3.5, 2.1 });
//يمكن أيضًا إزالة سلسلة الرسم البياني بواسطة الفهرس، مثل هذا.
// سيؤدي هذا إلى إزالة إحدى سلاسل العروض التوضيحية الثلاثة التي جاءت مع الرسم البياني.
chartData.RemoveAt(2);

Assert.False(chartData.Any(s => s.Name == "Series 3"));
//يمكننا أيضًا مسح جميع بيانات الرسم البياني مرة واحدة باستخدام هذه الطريقة.
// عند إنشاء مخطط جديد، هذه هي الطريقة لمسح جميع بيانات العرض التوضيحي
// قبل أن نتمكن من البدء في العمل على مخطط فارغ.
chartData.Clear();

أنظر أيضا