إضافة قيم التاريخ والوقت إلى محور الرسم البياني

مقدمة

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

المتطلبات الأساسية

قبل أن نبدأ، تأكد من توفر المتطلبات الأساسية التالية:

  1. Visual Studio أو أي .NET IDE: تحتاج إلى بيئة تطوير لكتابة وتشغيل كود .NET الخاص بك.
  2. Aspose.Words for .NET: يجب أن يكون لديك مكتبة Aspose.Words for .NET مثبتة. يمكنك تنزيلها منهنا.
  3. المعرفة الأساسية بلغة C#: يفترض هذا البرنامج التعليمي أن لديك فهمًا أساسيًا لبرمجة C#.
  4. ترخيص Aspose صالح: يمكنك الحصول على ترخيص مؤقت منهنا.

استيراد مساحات الأسماء

للبدء، تأكد من استيراد مساحات الأسماء الضرورية في مشروعك. هذه الخطوة ضرورية للوصول إلى فئات وطرق Aspose.Words.

using System;
using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Drawing.Charts;

الخطوة 1: إعداد دليل المستندات الخاص بك

أولاً، عليك تحديد الدليل الذي سيتم حفظ المستند فيه. وهذا مهم لتنظيم ملفاتك وضمان تشغيل الكود الخاص بك بشكل صحيح.

string dataDir = "YOUR DOCUMENT DIRECTORY";

الخطوة 2: إنشاء مستند جديد وDocumentBuilder

بعد ذلك، قم بإنشاء مثيل جديد لـDocument الصف و أDocumentBuilder الكائنات. ستساعدك هذه الكائنات في إنشاء مستندك ومعالجته.

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

الخطوة 3: إدراج مخطط في المستند

الآن، قم بإدراج مخطط في مستندك باستخدامDocumentBuilder في هذا المثال، نستخدم مخططًا عموديًا، ولكن يمكنك اختيار أنواع أخرى أيضًا.

Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;

الخطوة 4: مسح السلسلة الموجودة

قم بمسح أي سلسلة موجودة في الرسم البياني للتأكد من أنك تبدأ بصفحة فارغة. هذه الخطوة ضرورية للبيانات المخصصة.

chart.Series.Clear();

الخطوة 5: إضافة قيم التاريخ والوقت إلى السلسلة

أضف قيم التاريخ والوقت إلى سلسلة المخططات البيانية. تتضمن هذه الخطوة إنشاء صفائف للتاريخ والقيم المقابلة.

chart.Series.Add("Aspose Series 1",
    new[]
    {
        new DateTime(2017, 11, 06), new DateTime(2017, 11, 09), new DateTime(2017, 11, 15),
        new DateTime(2017, 11, 21), new DateTime(2017, 11, 25), new DateTime(2017, 11, 29)
    },
    new double[] { 1.2, 0.3, 2.1, 2.9, 4.2, 5.3 });

الخطوة 6: تكوين المحور X

اضبط مقياس وعلامات التحديد للمحور X. يضمن هذا عرض التواريخ بشكل صحيح وعلى فترات زمنية مناسبة.

ChartAxis xAxis = chart.AxisX;
xAxis.Scaling.Minimum = new AxisBound(new DateTime(2017, 11, 05).ToOADate());
xAxis.Scaling.Maximum = new AxisBound(new DateTime(2017, 12, 03).ToOADate());
xAxis.MajorUnit = 7;
xAxis.MinorUnit = 1;
xAxis.MajorTickMark = AxisTickMark.Cross;
xAxis.MinorTickMark = AxisTickMark.Outside;

الخطوة 7: حفظ المستند

أخيرًا، احفظ مستندك في الدليل المحدد. تنهي هذه الخطوة العملية، ويجب أن يحتوي مستندك الآن على مخطط بقيم التاريخ والوقت على المحور X.

doc.Save(dataDir + "WorkingWithCharts.DateTimeValuesToAxis.docx");

خاتمة

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

الأسئلة الشائعة

هل يمكنني استخدام أنواع أخرى من المخططات مع Aspose.Words لـ .NET؟

نعم، يدعم Aspose.Words أنواعًا مختلفة من المخططات، بما في ذلك المخطط الخطي، والمخطط الشريطي، والمخطط الدائري، والمزيد.

كيف يمكنني تخصيص مظهر الرسم البياني الخاص بي؟

يمكنك تخصيص المظهر من خلال الوصول إلى خصائص الرسم البياني وتعيين الأنماط والألوان والمزيد.

هل من الممكن إضافة سلاسل متعددة إلى مخطط؟

بالتأكيد! يمكنك إضافة سلاسل متعددة إلى مخططك عن طريق الاتصال بـSeries.Add الطريقة عدة مرات مع بيانات مختلفة.

ماذا لو كنت بحاجة إلى تحديث بيانات الرسم البياني بشكل ديناميكي؟

بإمكانك تحديث بيانات الرسم البياني بشكل ديناميكي عن طريق معالجة خصائص السلسلة والمحور برمجيًا استنادًا إلى متطلباتك.

أين يمكنني العثور على المزيد من الوثائق التفصيلية لـ Aspose.Words لـ .NET؟

يمكنك العثور على وثائق أكثر تفصيلاهنا.