ضبط تنسيق حقل الصفحة برمجيًا في .NET

مقدمة

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

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

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

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

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

للبدء، ستحتاج إلى استيراد الحزم الصحيحة في مشروعك. ابدأ بإضافة مراجع إلى مكتبة Aspose.Cells في مشروع C# الخاص بك. وإليك كيفية القيام بذلك:

using System.IO;
using Aspose.Cells;
using System.Drawing;
using Aspose.Cells.Pivot;

سيؤدي هذا إلى جلب جميع الفئات والطرق اللازمة للتعامل مع ملفات Excel باستخدام Aspose.Cells.

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

ابدأ بتحديد دليل العمل الذي سيتم تخزين ملفات Excel فيه. على سبيل المثال، يمكنك إعلان متغير مثل هذا:

string dataDir = "Your Document Directory";

تحميل المصنف

بعد ذلك، نحتاج إلى تحميل قالب Excel الخاص بنا. هذه خطوة أساسية لأنها تحدد السياق لعملياتنا:

Workbook workbook = new Workbook(dataDir + "Book1.xls");

يقوم هذا السطر بتحميل المصنف الموجود من الدليل المحدد.

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

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

Worksheet worksheet = workbook.Worksheets[0];

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

الخطوة 3: الوصول إلى جدول البيانات المحوري

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

int pivotindex = 0;
// الوصول إلى جدول البيانات المحوري
PivotTable pivotTable = worksheet.PivotTables[pivotindex];

يقوم مقتطف التعليمات البرمجية هذا بتحديد الجدول المحوري الأول في ورقة العمل.

الخطوة 4: تكوين جدول البيانات المحوري

الآن يأتي الجزء المثير! فلنضبط جدول البيانات المحوري لإظهار الإجماليات الكلية للصفوف:

pivotTable.RowGrand = true;

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

الخطوة 5: الوصول إلى حقول الصفوف وتكوينها

بعد ذلك، نحتاج إلى الوصول إلى حقول الصفوف في جدول PivotTable:

Aspose.Cells.Pivot.PivotFieldCollection pivotFields = pivotTable.RowFields;

تتيح لنا هذه المجموعة إمكانية معالجة الحقول حسب الحاجة.

تكوين حقل الصف الأول

هل تريد تعيين أنواع إجماليات فرعية محددة؟ دعنا نصل إلى الحقل الأول في مجموعتنا ونقوم بتكوينه:

Aspose.Cells.Pivot.PivotField pivotField = pivotFields[0];
// إعداد الإجماليات الفرعية.
pivotField.SetSubtotals(Aspose.Cells.Pivot.PivotFieldSubtotalType.Sum, true);
pivotField.SetSubtotals(Aspose.Cells.Pivot.PivotFieldSubtotalType.Count, true);

من خلال تمكينSum وCount من خلال الإجماليات الفرعية، يمكننا تلخيص البيانات بسرعة في تقريرنا.

الخطوة 6: ضبط خيارات الفرز التلقائي

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

// ضبط خيارات الفرز التلقائي.
pivotField.IsAutoSort = true;
pivotField.IsAscendSort = true;
pivotField.AutoSortField = -5; // استخدام حقل الفرز المحدد مسبقًا.

يتيح مقتطف التعليمات البرمجية هذا الفرز التلقائي ويحدد الترتيب التصاعدي.

الخطوة 7: ضبط خيارات العرض التلقائي

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

// ضبط خيارات العرض التلقائي.
pivotField.IsAutoShow = true;
pivotField.IsAscendShow = false;
pivotField.AutoShowField = 0; // حدد الحقل لإظهاره تلقائيًا.

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

الخطوة 8: حفظ عملك

بعد كل هذه التكوينات، لن ترغب في فقدان عملك! احفظ المصنف المعدّل على النحو التالي:

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

الآن، يمكنك العثور على ملف Excel الذي تم إنشاؤه حديثًا في دليل المستندات الخاص بك.

خاتمة

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

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

ما هو Aspose.Cells؟

Aspose.Cells عبارة عن مكتبة .NET تتيح للمطورين إنشاء ملفات Excel ومعالجتها وتحويلها برمجيًا.

كيف أقوم بتثبيت Aspose.Cells؟

يمكنك تنزيله مباشرة منموقع اسبوس.

هل يمكنني استخدام Aspose.Cells دون تثبيت Excel؟

نعم، Aspose.Cells عبارة عن مكتبة مستقلة لا تتطلب تثبيت Microsoft Excel.

أين يمكنني العثور على الدعم المفصل؟

يمكنك الوصول إلى الدعم والمنتديات التفصيلية علىدعم Aspose.

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

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

ضبط خيارات التنسيق لجدول Pivot في .NET خيار إظهار صفحات تصفية التقارير في .NET