تنسيق كائنات القائمة في Excel باستخدام Aspose.Cells

مقدمة

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

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

قبل القفز إلى عملية الترميز، تأكد من إعداد بعض الأشياء:

Visual Studio أو أي .NET IDE: ستحتاج إلى بيئة تطوير لكتابة وتشغيل كود .NET الخاص بك.
Aspose.Cells لـ .NET: تأكد من تثبيت مكتبة Aspose.Cells. يمكنك تنزيلها من صفحة تنزيل Aspose.Cells لـ .NET أو قم بتثبيته عبر NuGet في Visual Studio.
المعرفة الأساسية بـ .NET: يفترض هذا الدليل الإلمام بـ C# و .NET.
ترخيص Aspose (اختياري): للحصول على الوظائف الكاملة بدون علامات مائية، فكر في الحصول على ترخيص Aspose رخصة مؤقتة أو شراء واحدة هنا .

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

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

using System.IO;
using Aspose.Cells;

دعونا نقسم العملية إلى خطوات سهلة الفهم، كل منها تحتوي على تعليمات واضحة.

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

قبل حفظ أي ملفات، دعنا نحدد الدليل الذي سيتم حفظ ملفات الإخراج فيه. سيتم استخدام مسار الدليل هذا لإنشاء ملف Excel الناتج وتخزينه.

string dataDir = "Your Document Directory";
// التحقق من وجود الدليل؛ إذا لم يكن موجودًا، قم بإنشائه
if (!System.IO.Directory.Exists(dataDir))
    System.IO.Directory.CreateDirectory(dataDir);

الخطوة 2: إنشاء مصنف جديد

يُعد المصنف في Excel بمثابة ملف أو جدول بيانات جديد. هنا، نقوم بإنشاء مثيل جديد منWorkbook الفئة التي تحمل بياناتنا.

Workbook workbook = new Workbook();

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

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

Worksheet sheet = workbook.Worksheets[0];

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

الآن يأتي الجزء الممتع - إضافة البيانات! فلنقم بملء سلسلة من الخلايا لبناء جدول بيانات بسيط. يمكن أن تمثل هذه البيانات مجموعة بيانات صغيرة، مثل المبيعات الفصلية حسب الموظفين والمناطق.

Cells cells = sheet.Cells;
// إضافة رؤوس الصفحات
cells["A1"].PutValue("Employee");
cells["B1"].PutValue("Quarter");
cells["C1"].PutValue("Product");
cells["D1"].PutValue("Continent");
cells["E1"].PutValue("Country");
cells["F1"].PutValue("Sale");
// إضافة بيانات العينة
cells["A2"].PutValue("David");
cells["A3"].PutValue("David");
// إضافة المزيد من الصفوف...
cells["B2"].PutValue(1);
cells["C2"].PutValue("Maxilaku");
// استمر في إضافة المزيد من البيانات حسب المتطلبات

هذه البيانات مجرد مثال، ويمكنك تخصيصها وفقًا لاحتياجاتك المحددة.

الخطوة 5: إضافة كائن القائمة (الجدول) إلى ورقة العمل

في برنامج Excel، يشير “كائن القائمة” إلى جدول. فلنقم بإضافة كائن القائمة هذا إلى النطاق الذي يحتوي على بياناتنا. وهذا من شأنه أن يسهل تطبيق وظائف التنسيق والتلخيص.

Aspose.Cells.Tables.ListObject listObject = sheet.ListObjects[sheet.ListObjects.Add("A1", "F15", true)];

هنا،"A1" ل"F15" هو النطاق الذي يغطي بياناتنا.true تعني المعلمة أن الصف الأول (الصف 1) يجب أن يتم التعامل معه كعناوين.

الخطوة 6: تصميم الجدول

الآن بعد إعداد الجدول، دعنا نضيف بعض الأنماط إليه. يوفر Aspose.Cells مجموعة من أنماط الجدول المحددة مسبقًا، والتي يمكنك الاختيار من بينها. هنا، سنطبق نمطًا متوسطًا.

listObject.TableStyleType = TableStyleType.TableStyleMedium10;

تجربة أنماط مختلفة (مثلTableStyleMedium9 أوTableStyleDark1) للعثور على ما يناسب احتياجاتك.

الخطوة 7: عرض صف الإجماليات

دعنا نضيف صفًا للمجموعات لتلخيص بياناتنا.ShowTotals ستعمل الخاصية على تمكين صف جديد في أسفل الجدول.

listObject.ShowTotals = true;

الخطوة 8: تعيين نوع الحساب لصف الإجماليات

في صف الإجماليات، يمكننا تحديد نوع الحساب الذي نريده لكل عمود. على سبيل المثال، لنحسب عدد الإدخالات في عمود “الربع”.

listObject.ListColumns[1].TotalsCalculation = TotalsCalculation.Count;

يحدد هذا السطر من التعليمات البرمجية حساب الإجماليات لعمود “الربع” إلىCount يمكنك أيضًا استخدام خيارات مثلSum, Average، والمزيد بناءً على احتياجاتك.

الخطوة 9: احفظ المصنف

وأخيرًا، دعنا نحفظ المصنف كملف Excel في الدليل الذي أنشأناه سابقًا.

workbook.Save(dataDir + "output.xlsx");

سيؤدي هذا إلى إنشاء ملف Excel منسق ومنسق بالكامل يحتوي على الجدول الخاص بك.

خاتمة

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

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

ما هو Aspose.Cells؟

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

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

نعم يمكنك الحصول على نسخة تجريبية مجانية من Aspose.Cells لاستكشاف ميزاته. للحصول على وصول كامل دون قيود، فكر في الحصول على رخصة مؤقتة .

كيف أضيف المزيد من الأنماط إلى جدول Excel الخاص بي؟

يقدم Aspose.Cells مجموعة متنوعة منTableStyleType خيارات لتصميم الجداول. جرب قيمًا مختلفة مثلTableStyleLight1 أوTableStyleDark10 لتغيير مظهر الجدول الخاص بك.

هل يمكنني استخدام صيغ مخصصة في صف الإجماليات؟

بالتأكيد! يمكنك تعيين صيغ مخصصة باستخدامListColumn.TotalsCalculationخاصية لتطبيق حسابات محددة مثل المجموع أو المتوسط أو الصيغ المخصصة.

هل من الممكن أتمتة ملفات Excel دون تثبيت Excel؟

نعم، Aspose.Cells عبارة عن واجهة برمجة تطبيقات مستقلة لا تتطلب تثبيت Microsoft Excel على الخادم أو الجهاز الذي يقوم بتشغيل الكود.

Go Top