إنشاء الرسوم البيانية في المستندات باستخدام csharp

بصفتك مطور C # ، يمكنك إدراج أنواع مختلفة من المخططات في مستندات Word برمجيًا. يساعد على تقديم بياناتك ومعلوماتك بيانياً. في هذه المقالة ، ستتعلم كيفية إنشاء مخططات في مستندات Word باستخدام C #.

تتم مناقشة / تغطية الموضوعات التالية في هذه المقالة:

C # API لإدراج الرسوم البيانية في مستندات Word

لإدخال الرسوم البيانية في ملفات DOCX ، سنستخدم Aspose.Words for .NET API. يتيح لك إنشاء الملفات وتعديلها وتحويلها وعرضها وطباعتها دون استخدام Microsoft Word مباشرة داخل التطبيقات عبر الأنظمة الأساسية. تمكّنك واجهة برمجة التطبيقات من إدراج العديد من أنواع المخططات المدعومة في مستندات Word برمجيًا.

يمكنك إما تنزيل DLL الخاصة بواجهة برمجة التطبيقات أو تثبيته باستخدام NuGet.

Install-Package Aspose.Words

قم بإنشاء مخططات أعمدة في مستندات Word

يمكنك إنشاء مخططات أعمدة في مستندات Word برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مستند جديد باستخدام فئة Document.
  • الآن ، قم بإنشاء مثيل لفئة DocumentBuilder باستخدام كائن فئة المستند.
  • ثم قم باستدعاء الأسلوب DocumentBuilder.InsertChart (). قم بتمرير ChartType كعمود ، مع الارتفاع والعرض كمعلمات إدخال.
  • الحصول على نتائج في كائن فئة الشكل.
  • الآن ، قم بإنشاء مثيل لفئة Chart وقم بتعيين كائن Shape.Chart لها. يوفر الوصول إلى خصائص المخطط إذا كان هذا الشكل يحتوي على مخطط.
  • بعد ذلك ، احصل على مجموعة سلاسل المخططات في كائن ChartSeriesCollection.
  • إنشاء مصفوفة أسماء الفئات.
  • الآن ، قم باستدعاء الأسلوب ChartSeriesCollection.Add () لإضافة سلسلة المخططات. اسم المرور ، صفيف الفئة والقيم كمعلمات إدخال. كرر هذه الخطوة لإضافة المزيد من السلاسل.
  • أخيرًا ، قم باستدعاء الأسلوب Document.Save () مع مسار ملف الإخراج لحفظ الملف.

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء مخطط أعمدة في مستند Word باستخدام C #.

// قم بإنشاء مستند
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أضف مخططًا بالبيانات الافتراضية. يمكنك تحديد أنواع وأحجام مختلفة من المخططات.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// تحتوي خاصية المخطط للشكل على كافة الخيارات المتعلقة بالرسم البياني.
Chart chart = shape.Chart;

// الحصول على مجموعة سلسلة الرسم البياني.
ChartSeriesCollection seriesColl = chart.Series;
// تحقق من عدد المتسلسلات.
Console.WriteLine(seriesColl.Count);

// حذف سلسلة تم إنشاؤها الافتراضية.
seriesColl.Clear();

// إنشاء مصفوفة أسماء الفئات ، في هذا المثال لدينا فئتان.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// مضيفا مسلسل جديد. الرجاء ملاحظة أنه يجب ألا تكون صفائف البيانات فارغة ويجب أن تكون المصفوفات بنفس الحجم.
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });

// احفظ المستند
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
قم بإنشاء مخططات أعمدة في مستندات Word باستخدام C #.

إنشاء مخططات أعمدة في مستندات Word باستخدام C #

إنشاء مخططات مبعثرة في مستندات Word باستخدام C

يمكنك إدراج المخططات المبعثرة في مستندات Word برمجيًا باتباع الخطوات المذكورة سابقًا. ومع ذلك ، تحتاج إلى تعيين ChartType.Scatter في طريقة DocumentBuilder.InsertChart ().

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء مخطط مبعثر في مستند Word باستخدام C #.

// قم بإنشاء مستند جديد
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// إدراج مخطط مبعثر.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// استخدم هذا التحميل الزائد لإضافة سلسلة إلى أي نوع من المخططات المبعثرة.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// احفظ المستند
doc.Save(@"C:\Files\Words\ScatterChart.docx");
أنشئ مخططات مبعثرة في مستندات Word باستخدام C #.

إنشاء مخططات مبعثرة في مستندات Word باستخدام C #

إدراج مخططات مساحية في مستندات Word باستخدام C

يمكنك إدراج مخططات مساحية في مستندات Word برمجيًا باتباع الخطوات المذكورة سابقًا. ومع ذلك ، تحتاج إلى تعيين ChartType.Area في طريقة DocumentBuilder.InsertChart ().

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء مخطط مساحي في مستند Word باستخدام C #.

// قم بإنشاء مستند جديد
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// إدراج مخطط مساحي.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// استخدم هذا التحميل الزائد لإضافة سلسلة إلى أي نوع من مخططات المساحة والرادار والأسهم.
chart.Series.Add("AW Series 1", new DateTime[] {
    new DateTime(2002, 05, 01),
    new DateTime(2002, 06, 01),
    new DateTime(2002, 07, 01),
    new DateTime(2002, 08, 01),
    new DateTime(2002, 09, 01)},
    new double[] { 32, 32, 28, 12, 15 });

// احفظ المستند
doc.Save(@"C:\Files\Words\AreaChart.docx");
أدخل المخططات المساحية في مستندات Word باستخدام C #.

إدراج مخططات مساحية في مستندات Word باستخدام C #

إدراج مخططات فقاعية في مستندات Word باستخدام C

يمكنك إدراج مخططات فقاعية في مستندات Word برمجيًا باتباع الخطوات المذكورة سابقًا. ومع ذلك ، تحتاج إلى تعيين ChartType.Bubble في طريقة DocumentBuilder.InsertChart ().

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء مخطط فقاعي في مستند Word باستخدام C #.

// قم بإنشاء مستند جديد
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// إدراج مخطط فقاعي.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// استخدم هذا التحميل الزائد لإضافة سلسلة إلى أي نوع من المخططات الفقاعية.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });

// احفظ المستند
doc.Save(@"C:\Files\Words\BubbleChart.docx");
أدخل المخططات الفقاعية في مستندات Word باستخدام C #.

إدراج مخططات فقاعية في مستندات Word باستخدام C #

احصل على رخصة مجانية

يمكنك تجربة واجهة برمجة التطبيقات بدون قيود التقييم من خلال طلب ترخيص مؤقت مجاني.

استنتاج

في هذه المقالة ، تعلمت كيفية إنشاء مخططات في مستندات Word باستخدام C #. على وجه الخصوص ، لقد تعلمت كيفية إنشاء المخططات العمودية والمساحية والفقاعية والمبعثرة في مستندات Word برمجيًا. وبالمثل ، يمكنك إنشاء أنواع أخرى من المخططات. يمكنك معرفة المزيد حول Aspose.Words for .NET API باستخدام التوثيق. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا