تخصيص تنسيقات العرض باستخدام أرقام محددة من قبل المستخدم

مقدمة

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

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

قبل أن تبدأ، تأكد من أنك أعددت كل ما يلزم لمتابعة هذا البرنامج التعليمي. إليك ما ستحتاج إليه:

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

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

قبل القفز إلى الكود، تحتاج إلى استيراد المساحات المطلوبة للوصول إلى جميع وظائف Aspose.Cells الضرورية.

using System.IO;
using Aspose.Cells;
using System;

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

الخطوة 1: إعداد دليل المشروع

أولاً، تحتاج إلى مكان لتخزين ملفاتك، أليس كذلك؟ دعنا ننشئ دليلاً لحفظ ملف Excel الناتج. في هذه الخطوة، سنتأكد أيضًا من وجود الدليل قبل حفظ أي شيء.

// المسار إلى دليل المستندات.
string dataDir = "Your Document Directory";
// إنشاء الدليل إذا لم يكن موجودًا بالفعل.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
  • نحن نقوم بتعريفdataDir متغير لتخزين المسار الذي سيتم وضع ملف Excel الناتج فيه.
  • ثم نتحقق مما إذا كان الدليل موجودًا باستخدامSystem.IO.Directory.Exists().
  • إذا لم يكن الدليل موجودًا، فسيتم إنشاؤه باستخدامSystem.IO.Directory.CreateDirectory().

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

الآن بعد أن حصلنا على الدليل، فلنقم بإنشاء مصنف Excel جديد وإضافة ورقة عمل إليه.

// إنشاء كائن مصنف
Workbook workbook = new Workbook();
// إضافة ورقة عمل جديدة إلى كائن Excel
int i = workbook.Worksheets.Add();
// الحصول على مرجع ورقة العمل المضافة حديثًا عن طريق تمرير فهرس الورقة الخاصة بها
Worksheet worksheet = workbook.Worksheets[i];
  • أولاً، نقوم بإنشاء ملف جديدWorkbook الكائن. فكر فيه كملف Excel الخاص بك.
  • نضيف ورقة عمل جديدة إلى هذا المصنف باستخدامAdd()الطريقة وتخزين الفهرس في المتغيرi.
  • نحن نشير إلى ورقة العمل هذه باستخدامworkbook.Worksheets[i].

الخطوة 3: إضافة التاريخ إلى خلية وتخصيص تنسيقها

الآن، دعنا ندرج التاريخ الحالي في خلية وننسقه لعرضه بطريقة مخصصة. بدلاً من تنسيق التاريخ الافتراضي، سنضبط تنسيقًا مخصصًا مثلd-mmm-yy.

// إضافة تاريخ النظام الحالي إلى الخلية "A1"
worksheet.Cells["A1"].PutValue(DateTime.Now);
// الحصول على نمط الخلية A1
Style style = worksheet.Cells["A1"].GetStyle();
// ضبط تنسيق العرض المخصص لإظهار التاريخ على هيئة "d-mmm-yy"
style.Custom = "d-mmm-yy";
// تطبيق النمط على الخلية A1
worksheet.Cells["A1"].SetStyle(style);
  • نضيف تاريخ النظام الحالي إلى الخليةA1 استخدامPutValue(DateTime.Now).
  • نحن نستعيد النمط الحالي للخليةA1 استخدامGetStyle().
  • نقوم بتعديل نمط الخلية عن طريق الضبطstyle.Custom = "d-mmm-yy"، الذي يقوم بتنسيق التاريخ لإظهار اليوم والشهر المختصر والسنة.
  • وأخيرًا، نطبق النمط الجديد على الخلية باستخدامSetStyle().

الخطوة 4: تنسيق الخلية كنسبة مئوية

بعد ذلك، دعنا نعمل بالأرقام. سنضيف قيمة عددية إلى خلية أخرى، على سبيل المثالA2، وتنسيقها كنسبة مئوية.

//إضافة قيمة عددية إلى الخلية "A2"
worksheet.Cells["A2"].PutValue(20);
// الحصول على نمط الخلية A2
style = worksheet.Cells["A2"].GetStyle();
// ضبط تنسيق العرض المخصص لإظهار القيمة كنسبة مئوية
style.Custom = "0.0%";
// تطبيق النمط على الخلية A2
worksheet.Cells["A2"].SetStyle(style);
  • نحن نضيف القيمة20 الى الخليةA2.
  • نحن نستعيد نمط الخليةA2 وضبط التنسيق المخصص إلى0.0% لعرض القيمة كنسبة مئوية (أي 20%).
  • وأخيرًا، نطبق النمط على الخلية باستخدامSetStyle().

الخطوة 5: تنسيق الخلية كعملة

دعنا نضيف قيمة أخرى، لنقل إلى الخليةA3، وتنسيقه لعرضه كعملة. ولجعل الأمور أكثر تشويقًا، سنستخدم تنسيقًا يعرض القيم الإيجابية كعملة بالجنيه الإسترليني والقيم السلبية بالدولار.

// إضافة قيمة عددية إلى الخلية "A3"
worksheet.Cells["A3"].PutValue(2546);
// الحصول على نمط الخلية A3
style = worksheet.Cells["A3"].GetStyle();
// ضبط تنسيق العرض المخصص لإظهار القيمة كعملة
style.Custom = "£#,##0;[Red]$-#,##0";
// تطبيق النمط على خلية A3
worksheet.Cells["A3"].SetStyle(style);
  • نحن نضيف القيمة2546 الى الخليةA3.
  • لقد قمنا بتعيين تنسيق مخصص£#,##0;[Red]$-#,##0، والذي يعرض القيم الإيجابية بعلامة الجنيه والقيم السلبية باللون الأحمر مع علامة الدولار.
  • نقوم بتطبيق النمط على الخلية باستخدامSetStyle().

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

الخطوة الأخيرة هي حفظ المصنف كملف Excel. سنستخدم تنسيق Excel 97-2003 لهذا البرنامج التعليمي.

// حفظ ملف Excel
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);
  • الSave() تحفظ الطريقة المصنف في الدليل المحدد.
  • نحن نختارSaveFormat.Excel97To2003 لضمان التوافق مع الإصدارات الأقدم من Excel.

خاتمة

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

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

كيف يمكنني تطبيق خيارات التنسيق الأكثر تعقيدًا في Aspose.Cells؟

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

هل يمكنني تطبيق تنسيق رقم مخصص على نطاق من الخلايا؟

نعم، يسمح لك Aspose.Cells بتطبيق نمط على نطاق من الخلايا باستخدامRange.SetStyle() طريقة.

ما هي تنسيقات الملفات الأخرى التي يمكنني حفظ المصنف بها؟

يدعم Aspose.Cells العديد من التنسيقات، بما في ذلك XLSX وCSV وPDF. ما عليك سوى تغييرSaveFormat فيSave() طريقة.

هل يمكنني تنسيق الأرقام السالبة بشكل مختلف؟

بالتأكيد! يمكنك استخدام تنسيقات أرقام مخصصة لعرض الأرقام السالبة بألوان أو رموز مختلفة.

هل Aspose.Cells لـ .NET مجاني؟

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

استخدام تنسيقات الأرقام المضمنة في برنامج Excel برمجيًا