قراءة تسميات المحور بعد حساب الرسم البياني

مقدمة

عند العمل مع ملفات Excel في .NET، تعد Aspose.Cells واحدة من أقوى المكتبات المتاحة لك. فهي تتيح لك التعامل مع جداول البيانات دون عناء، سواء كنت تقرأ البيانات أو تنشئ مخططات أو تقوم بحسابات معقدة. في هذا البرنامج التعليمي، سنتعمق في وظيفة محددة: قراءة تسميات المحاور من مخطط بعد حسابه. إذا تساءلت يومًا عن كيفية استخراج هذه التسميات برمجيًا، فأنت في المكان الصحيح! سنقوم بتقسيمها خطوة بخطوة، مع توفير جميع التفاصيل الضرورية على طول الطريق.

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

قبل أن نتعمق في التفاصيل الدقيقة للكود، دعنا نتأكد من أن لديك كل ما تحتاجه للبدء:

  1. Visual Studio: يجب أن يكون لديك Visual Studio مثبتًا على جهازك. إذا لم يكن مثبتًا لديك بعد، فيمكنك تنزيله منموقع مايكروسوفت.
  2. مكتبة Aspose.Cells: يفترض هذا الدليل أن لديك مكتبة Aspose.Cells. يمكنك تنزيلها بسهولة منصفحة إصدار Asposeإذا كنت غير متأكد من أين تبدأ،توثيق Aspose.Cells يمكن أن يكون أفضل صديق لك!
  3. المعرفة الأساسية بلغة C#: ستساعدك المعرفة بلغة البرمجة C# على فهم الأمثلة ومتابعتها دون أي عوائق.
  4. ملف Excel: تأكد من أن لديك ملف Excel يحتوي على مخططات لهذا البرنامج التعليمي. يمكنك إنشاء ملف Excel نموذجي باسمsampleReadAxisLabelsAfterCalculatingTheChart.xlsx لأغراض الاختبار.
  5. بيئة .NET: تأكد من إعداد بيئة .NET الخاصة بك بشكل صحيح. يستهدف هذا البرنامج التعليمي إطار عمل .NET، لذا تأكد من أنك جاهز للبدء!

الآن بعد أن أصبح لدينا كل ما نحتاجه، فلننتقل إلى الإعداد والرمز!

استيراد الحزم

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

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using Aspose.Cells.Charts;
using System.Collections;

وهنا ما يفعله كل واحد منهم:

  • Aspose.Cells: تتيح لك هذه المساحة الوصول إلى جميع الوظائف التي توفرها مكتبة Aspose.Cells.
  • النظام: مساحة اسم أساسية للوظائف الأساسية في لغة C#، مثل عمليات وحدة التحكم.
  • System.Collections: هذه المساحة ضرورية لاستخدام مجموعات مثلArrayList، والتي سنستخدمها لحمل تسميات المحاور الخاصة بنا.

بمجرد إضافة هذه الواردات، ستكون جاهزًا للبدء في الأجزاء المهمة من الترميز!

الخطوة 1: تحديد دليل المصدر الخاص بك

ابدأ بإعداد مسار الدليل الذي يوجد به ملف Excel الخاص بك.

string sourceDir = "Your Document Directory";

يستبدل"Your Document Directory" مع المسار الفعلي الذي يوجد به ملف Excel الخاص بك (sampleReadAxisLabelsAfterCalculatingTheChart.xlsx) يتم تخزينه. هذا يخبر البرنامج بمكان العثور على الملف.

الخطوة 2: تحميل المصنف

الآن، دعنا نحمل المصنف (ملف Excel الخاص بك) باستخدامWorkbook فصل.

Workbook wb = new Workbook(sourceDir + "sampleReadAxisLabelsAfterCalculatingTheChart.xlsx");

الWorkbook الفصل هو بوابة الدخول إلى ملف Excel. من خلال توفير المسار الكامل، نقوم بإنشاء مثيل جديد للمصنف يحتوي على بيانات Excel الخاصة بنا.

الخطوة 3: الوصول إلى ورقة العمل الأولى

بعد ذلك، ستحتاج إلى الوصول إلى ورقة العمل الأولى في المصنف.

Worksheet ws = wb.Worksheets[0];

أوراق العمل مفهرسة بالصفر، لذا0 يشير إلى الورقة الأولى. يتيح لنا هذا السطر الوصول إلى جميع الخلايا والمخططات الموجودة في ورقة العمل هذه.

الخطوة 4: الوصول إلى الرسم البياني

الآن تأتي الخطوة الحاسمة - الوصول إلى الرسم البياني نفسه.

Chart ch = ws.Charts[0];

وبالمثل، يتم فهرسة المخططات أيضًا. وهذا يتيح لنا الحصول على المخطط الأول في ورقة العمل. ويمكنك أيضًا الوصول إلى مخططات أخرى بفهرس مختلف.

الخطوة 5: احسب الرسم البياني

قبل أن تتمكن من قراءة تسميات المحور، يجب عليك التأكد من حساب الرسم البياني.

ch.Calculate();

يضمن حساب الرسم البياني تحديث كافة البيانات والعلامات وفقًا لأحدث البيانات في ورقة العمل الخاصة بك. الأمر أشبه بإعادة شحن البطارية قبل استخدامها!

قراءة تسميات المحور

الخطوة 6: الوصول إلى محور الفئة

الآن، دعونا نقرأ تسميات المحور من محور الفئة.

ArrayList lstLabels = ch.CategoryAxis.AxisLabels;

هنا، نقوم بسحب العلامات من محور الفئة وتخزينها فيArrayListتُعد هذه القائمة ضرورية لتكرار عرض العلامات الخاصة بك.

الخطوة 7: طباعة تسميات المحور على وحدة التحكم

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

Console.WriteLine("Category Axis Labels: ");
Console.WriteLine("---------------------");

// تكرار تسميات المحاور وطباعتها واحدة تلو الأخرى
for (int i = 0; i < lstLabels.Count; i++)
{
    Console.WriteLine(lstLabels[i]);
}

يقوم هذا المقطع أولاً بإخراج عنوان وسطر فاصل. ثم ننتقل عبر كل تسمية فيlstLabelsArrayList وطباعته في وحدة التحكم. إذا كان هناك عشرة تسميات، فسترى كل واحدة منها هناك!

الخطوة 8: الرسالة النهائية

بمجرد الانتهاء، دعونا نعطي رسالة النجاح النهائية للمستخدم.

Console.WriteLine("ReadAxisLabelsAfterCalculatingTheChart executed successfully.");

هذا تذكير ودي بأن عمليتك سارت بسلاسة!

خاتمة

والآن لديك دليل كامل حول كيفية قراءة تسميات محاور الفئات من مخطط في ملف Excel باستخدام مكتبة Aspose.Cells لـ .NET. الأمر بسيط للغاية، أليس كذلك؟ فباستخدام بضعة أسطر فقط من التعليمات البرمجية، يمكنك سحب المعلومات المهمة من جداول البيانات الخاصة بك ودمجها في تطبيقاتك بسلاسة.

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

ما هو Aspose.Cells؟

Aspose.Cells هي مكتبة قوية للتعامل مع ملفات Excel في .NET. وهي توفر وظائف متنوعة مثل القراءة والكتابة ومعالجة المخططات.

هل يمكنني استخدام Aspose.Cells في فترة تجريبية مجانية؟

نعم! يمكنك تنزيل نسخة تجريبية مجانية منهنا.

كيف يمكنني شراء Aspose.Cells؟

يمكنك شراء ترخيص لـ Aspose.Cells من خلالصفحة الشراء.

أين يمكنني العثور على الدعم لـ Aspose.Cells؟

يمكنك زيارة منتدى Aspose للحصول على الدعمهنا.

هل يمكنني الحصول على رخصة مؤقتة؟

نعم! تقدم Aspose ترخيصًا مؤقتًا يمكنك طلبه منهذا الرابط.

التعامل مع وحدات المحور البياني التلقائية مثل Microsoft Excel