تخصيص تسمية بيانات الرسم البياني

مقدمة

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

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

قبل أن نبدأ، تأكد من أن لديك ما يلي:

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

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

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

using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Saving;
using Aspose.Words.Charts;

الخطوة 1: تهيئة المستند وDocumentBuilder

لإنشاء مستندات Word ومعالجتها، نحتاج أولاً إلى تهيئة مثيل لـDocument الصف و أDocumentBuilder هدف.

// المسار إلى دليل المستند الخاص بك
string dataDir = "YOUR DOCUMENT DIRECTORY";

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

توضيح

  • مستند doc: إنشاء مثيل جديد لفئة المستند.
  • منشئ DocumentBuilder: يساعد DocumentBuilder في إدراج المحتوى في كائن المستند.

الخطوة 2: إدراج مخطط

بعد ذلك، سنقوم بإدراج مخطط شريطي في المستند باستخدامDocumentBuilder هدف.

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

توضيح

  • الشكل الشكل: يمثل الرسم البياني كشكل في المستند.
  • builder.InsertChart(ChartType.Bar، 432، 252): يقوم بإدراج مخطط شريطي بأبعاد محددة.

الخطوة 3: الوصول إلى سلسلة المخططات

لتخصيص تسميات البيانات، نحتاج أولاً إلى الوصول إلى السلسلة في الرسم البياني.

ChartSeries series0 = shape.Chart.Series[0];

توضيح

  • ChartSeries series0: استرداد السلسلة الأولى من الرسم البياني، والتي سنقوم بتخصيصها.

الخطوة 4: تخصيص تسميات البيانات

يمكن تخصيص تسميات البيانات لعرض معلومات متنوعة. سنقوم بتكوين التسميات لإظهار مفتاح الأسطورة واسم السلسلة والقيمة، مع إخفاء اسم الفئة والنسبة المئوية.

ChartDataLabelCollection labels = series0.DataLabels;
labels.ShowLegendKey = true;
labels.ShowLeaderLines = true;
labels.ShowCategoryName = false;
labels.ShowPercentage = false;
labels.ShowSeriesName = true;
labels.ShowValue = true;
labels.Separator = "/";

توضيح

  • تسميات ChartDataLabelCollection: الوصول إلى تسميات البيانات الخاصة بالسلسلة.
  • labels.ShowLegendKey: يعرض مفتاح الأسطورة.
  • labels.ShowLeaderLines: يعرض خطوط القائد لعلامات البيانات الموضوعة بعيدًا عن نقاط البيانات.
  • labels.ShowCategoryName: إخفاء اسم الفئة.
  • labels.ShowPercentage: إخفاء قيمة النسبة المئوية.
  • labels.ShowSeriesName: يعرض اسم السلسلة.
  • labels.ShowValue: يعرض قيمة نقاط البيانات.
  • labels.Separator: تعيين الفاصل لعلامات البيانات.

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

وأخيرًا، قم بحفظ المستند في الدليل المحدد.

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

توضيح

  • doc.Save: يحفظ المستند بالاسم المحدد في الدليل المقدم.

خاتمة

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

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

ما هو Aspose.Words لـ .NET؟

Aspose.Words for .NET هي مكتبة معالجة مستندات قوية تتيح للمطورين إنشاء مستندات Word وتعديلها وتحويلها برمجيًا.

كيف أقوم بتثبيت Aspose.Words لـ .NET؟

يمكنك تنزيله وتثبيته منرابط التحميلاتبع تعليمات التثبيت المقدمة.

هل يمكنني تجربة Aspose.Words لـ .NET مجانًا؟

نعم يمكنك الحصول علىنسخة تجريبية مجانية أو أرخصة مؤقتةلتقييم المنتج.

هل Aspose.Words for .NET متوافق مع .NET Core؟

نعم، Aspose.Words for .NET متوافق مع .NET Core، و.NET Standard، و.NET Framework.

أين يمكنني الحصول على الدعم لـ Aspose.Words لـ .NET؟

يمكنك زيارةمنتدى الدعم للحصول على المساعدة والدعم من مجتمع Aspose والخبراء.