استخدام القائمة العامة في العلامات الذكية Aspose.Cells

مقدمة

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

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

قبل الغوص في الكود، دعنا نراجع سريعًا ما ستحتاج إليه:

المعرفة الأساسية بلغة C#

يجب أن يكون لديك فهم أساسي للغة C# وكيفية العمل مع الفئات والكائنات. إذا كنت متمكنًا من البرمجة الموجهة للكائنات، فأنت على المسار الصحيح بالفعل.

تم تثبيت Aspose.Cells لـ .NET

تأكد من تثبيت Aspose.Cells في مشروع .NET الخاص بك. يمكنك تنزيل المكتبة منموقع Aspose.

بيئة Visual Studio

يعد إعداد Visual Studio على جهازك أمرًا بالغ الأهمية. فهو بيئة التطوير الأكثر شيوعًا التي ستكتب فيها كود C#.

ملف قالب

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

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

الآن بعد أن أصبح لدينا الأساسيات في مكانها، فلنبدأ باستيراد الحزم الضرورية. القاعدة الأساسية الجيدة هي تضمين مساحة الأسماء التالية:

using System.IO;
using Aspose.Cells;
using System;
using System.Drawing;
using System.Collections.Generic;

ستوفر هذه المساحات الأسماءية الوظائف المطلوبة للعمل مع ملفات Excel وتصميم الخلايا.

الخطوة 1: تحديد فئاتك

أولاً وقبل كل شيء! نحن بحاجة إلى تحديد أهدافناPerson وTeacher الفصول الدراسية. إليك الطريقة:

تعريف فئة الشخص

الPerson ستحمل الفئة السمات الأساسية مثل الاسم والعمر.

public class Person
{
    int _age;
    string _name;
    
    public int Age
    {
        get { return _age; }
        set { _age = value; }
    }
    
    public string Name
    {
        get { return _name; }
        set { _name = value; }
    }
    
    public Person(string name, int age)
    {
        _age = age;
        _name = name;
    }
}

تحديد فئة المعلم

التالي هوTeacher الفئة التي ترث منPerson الصف. سيعمل هذا الفصل على تغليف قائمة الطلاب بشكل أكبر.

public class Teacher : Person
{
    private IList<Person> m_students;
    public IList<Person> Students
    {
        get { return m_students; }
        set { m_students = value; }
    }
    
    public Teacher(string name, int age) : base(name, age)
    {
        m_students = new List<Person>();
    }
}

الخطوة 2: تهيئة المصنف وإنشاء مصمم

الآن بعد أن أصبح لدينا فصولنا الدراسية في مكانها، حان الوقت لتهيئة مصنف العمل الخاص بنا:

string dataDir = "Your Document Directory"; // حدد دليل المستند الخاص بك
Workbook workbook = new Workbook(); // مثال جديد لكتاب العمل
Worksheet worksheet = workbook.Worksheets[0];

الخطوة 3: إعداد العلامات الذكية في ورقة العمل

سنقوم بإعداد علامات ذكية في ورقة عمل Excel، للإشارة إلى المكان الذي سيتم وضع القيم الديناميكية فيه.

worksheet.Cells["A1"].PutValue("Teacher Name");
worksheet.Cells["A2"].PutValue("&=Teacher.Name");
worksheet.Cells["B1"].PutValue("Teacher Age");
worksheet.Cells["B2"].PutValue("&=Teacher.Age");
worksheet.Cells["C1"].PutValue("Student Name");
worksheet.Cells["C2"].PutValue("&=Teacher.Students.Name");
worksheet.Cells["D1"].PutValue("Student Age");
worksheet.Cells["D2"].PutValue("&=Teacher.Students.Age");

الخطوة 4: تطبيق التصميم لتحسين العرض التقديمي

يجب أن يكون أي تقرير جيد جذابًا بصريًا! دعنا نطبق بعض الأسلوب على عناويننا:

Range range = worksheet.Cells.CreateRange("A1:D1");
Style style = workbook.CreateStyle();
style.Font.IsBold = true;
style.ForegroundColor = Color.Yellow;
style.Pattern = BackgroundType.Solid;
StyleFlag flag = new StyleFlag();
flag.All = true;
range.ApplyStyle(style, flag);

الخطوة 5: إنشاء مثيلات المعلم والطالب

الآن، دعنا ننشئ حالات منTeacher وPerson الفصول الدراسية وملئها بالبيانات:

System.Collections.Generic.List<Teacher> list = new System.Collections.Generic.List<Teacher>();
// إنشاء أول كائن المعلم
Teacher h1 = new Teacher("Mark John", 30);
h1.Students = new List<Person>
{
    new Person("Chen Zhao", 14),
    new Person("Jamima Winfrey", 18),
    new Person("Reham Smith", 15)
};
//إنشاء كائن المعلم الثاني
Teacher h2 = new Teacher("Masood Shankar", 40);
h2.Students = new List<Person>
{
    new Person("Karishma Jathool", 16),
    new Person("Angela Rose", 13),
    new Person("Hina Khanna", 15)
};
// أضف إلى القائمة
list.Add(h1);
list.Add(h2);

الخطوة 6: تعيين مصدر البيانات للمصمم

الآن علينا ربط بياناتنا مع ورقة العمل التي أعددناها.

WorkbookDesigner designer = new WorkbookDesigner();
designer.Workbook = workbook;
designer.SetDataSource("Teacher", list);

الخطوة 7: معالجة العلامات

الخطوة التالية هي معالجة جميع العلامات الذكية التي وضعناها سابقًا:

designer.Process();

الخطوة 8: ضبط الأعمدة تلقائيًا وحفظ المصنف

للتأكد من أن كل شيء يبدو احترافيًا، دعنا نضبط الأعمدة تلقائيًا ونحفظ المصنف الخاص بنا:

worksheet.AutoFitColumns();
designer.Workbook.Save(dataDir + "output.xlsx"); // حفظ في الدليل المحدد

خاتمة

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

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

ما هو Aspose.Cells؟

Aspose.Cells عبارة عن مكتبة .NET لإنشاء وإدارة ملفات Excel دون الحاجة إلى تثبيت Microsoft Excel.

هل يمكنني استخدام Aspose.Cells لتنسيقات الملفات الأخرى؟

نعم! توفر Aspose مكتبات لتنسيقات PDF وWord وغيرها من التنسيقات، مما يجعلها متعددة الاستخدامات لإدارة المستندات.

هل أحتاج إلى ترخيص لاستخدام Aspose.Cells؟

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

ما هي العلامات الذكية؟

العلامات الذكية عبارة عن عناصر نائبة في قوالب Excel يتم استبدالها ببيانات فعلية عند معالجتها بواسطة Aspose.Cells.

هل Aspose.Cells مناسب لمجموعات البيانات الكبيرة؟

بالتأكيد! تم تحسين Aspose.Cells لتحسين الأداء، مما يجعله قادرًا على التعامل مع مجموعات البيانات الكبيرة بكفاءة.