تحديد توافق ملف Excel برمجيًا في .NET

مقدمة

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

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

قبل الخوض في مرحلة الترميز، تأكد من توفر ما يلي:

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

بعد وضع هذه المتطلبات الأساسية في مكانها، فلنبدأ عملية الترميز.

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

قبل أن تبدأ في كتابة تطبيقك، يتعين عليك تضمين المساحات الأساسية اللازمة في الكود الخاص بك للاستفادة من مكتبة Aspose.Cells بشكل فعال. وإليك كيفية القيام بذلك.

استيراد مساحة اسم Aspose.Cells

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

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

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

الخطوة 1: إعداد الدليل الخاص بك

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

// المسار إلى دليل المستندات.
string dataDir = "Your Document Directory";

هنا، استبدل"Your Document Directory"مع المسار الفعلي لملفات Excel الخاصة بك. هذا هو المكان الذي يجب أن يوجد فيه ملف جدول البيانات المحوري الخاص بك.

الخطوة 2: تحميل ملف Excel المصدر

بعد ذلك، نحتاج إلى تحميل ملف Excel الذي يحتوي على جدول البيانات المحوري النموذجي.

// تحميل ملف مصدر Excel يحتوي على جدول محوري نموذجي
Workbook wb = new Workbook(dataDir + "sample-pivot-table.xlsx");

في هذه الخطوة، نقوم بإنشاء مثيل لـWorkbook الفئة التي تقوم بتحميل ملف Excel المحدد.

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

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

// الوصول إلى أول ورقة عمل تحتوي على بيانات جدول محوري
Worksheet dataSheet = wb.Worksheets[0];

هنا، نصل إلى ورقة العمل الأولى التي يوجد بها جدول البيانات المحوري. يمكنك أيضًا التنقل عبر أوراق العمل الأخرى أو تحديدها بناءً على بنية Excel الخاصة بك.

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

بعد ذلك، ستقوم بتعديل بعض قيم الخلايا في ورقة العمل.

الخطوة 4.1: تعديل الخلية A3

لنبدأ بالوصول إلى الخلية A3 وتعيين قيمتها.

// الوصول إلى الخلية A3 وتعيين بياناتها
Cells cells = dataSheet.Cells;
Cell cell = cells["A3"];
cell.PutValue("FooBar");

يقوم مقتطف التعليمات البرمجية هذا بتحديث الخلية A3 بالقيمة “FooBar”.

الخطوة 4.2: تعديل الخلية B3 باستخدام سلسلة طويلة

الآن، دعنا نضع سلسلة طويلة في الخلية B3، والتي تتجاوز حدود الأحرف القياسية في Excel.

// الوصول إلى الخلية B3 وتعيين بياناتها
string longStr = "Very long text 1. very long text 2.... [continue your long string]";
cell = cells["B3"];
cell.PutValue(longStr);

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

الخطوة 5: التحقق من طول الخلية B3

ومن الضروري أيضًا التأكد من طول السلسلة التي أدخلناها.

// طباعة طول السلسلة الخاصة بالخلية B3
Console.WriteLine("Length of original data string: " + cell.StringValue.Length);

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

الخطوة 6: تعيين قيم الخلايا الأخرى

الآن سوف نقوم بالوصول إلى المزيد من الخلايا وتعيين بعض القيم.

// الوصول إلى الخلية C3 وتعيين بياناتها
cell = cells["C3"];
cell.PutValue("closed");

// الوصول إلى الخلية D3 وتعيين بياناتها
cell = cells["D3"];
cell.PutValue("2016/07/21");

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

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

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

//قم بالوصول إلى ورقة العمل الثانية التي تحتوي على جدول محوري
Worksheet pivotSheet = wb.Worksheets[1];

// الوصول إلى الجدول المحوري
PivotTable pivotTable = pivotSheet.PivotTables[0];

تتيح لك هذه القطعة الصغيرة معالجة جدول المحور لإعدادات التوافق.

الخطوة 8: ضبط التوافق مع Excel 2003

من المهم تحديد ما إذا كان جدول البيانات المحوري الخاص بك متوافقًا مع Excel 2003 أم لا.

// تخبرك الخاصية IsExcel2003Compatible ما إذا كان PivotTable متوافقًا مع Excel2003 أثناء تحديث PivotTable
pivotTable.IsExcel2003Compatible = true;
pivotTable.RefreshData();
pivotTable.CalculateData();

وهنا يبدأ التحول الحقيقي. من خلال تحديدIsExcel2003Compatible لtrue، يمكنك تقييد طول الأحرف إلى 255 عند التحديث.

الخطوة 9: التحقق من الطول بعد إعداد التوافق

بعد ضبط التوافق، دعنا نرى كيف يؤثر ذلك على البيانات.

// التحقق من قيمة الخلية B5 في ورقة المحور.
Cell b5 = pivotSheet.Cells["B5"];
Console.WriteLine("Length of cell B5 after setting IsExcel2003Compatible property to True: " + b5.StringValue.Length);

من المرجح أن ترى إخراجًا يؤكد تأثير الاقتطاع إذا تجاوزت البيانات الأولية 255 حرفًا.

الخطوة 10: تغيير إعدادات التوافق

الآن، دعنا نغيّر إعدادات التوافق ونتحقق منها مرة أخرى.

//الآن قم بتعيين الخاصية IsExcel2003Compatible إلى false ثم قم بالتحديث مرة أخرى
pivotTable.IsExcel2003Compatible = false;
pivotTable.RefreshData();
pivotTable.CalculateData();

يتيح لك هذا أن تعكس بياناتك طولها الأصلي دون القيود السابقة.

الخطوة 11: التحقق من الطول مرة أخرى

دعونا نتأكد من أن البيانات تعكس الآن طولها الحقيقي بشكل دقيق.

// سيتم الآن طباعة الطول الأصلي لبيانات الخلية. لم يتم اقتطاع البيانات الآن.
b5 = pivotSheet.Cells["B5"];
Console.WriteLine("Length of cell B5 after setting IsExcel2003Compatible property to False: " + b5.StringValue.Length);

يجب أن ترى أن الإخراج يؤكد إزالة القطع.

الخطوة 12: تنسيق الخلايا

لتحسين التجربة البصرية، قد ترغب في تنسيق الخلايا.

// تعيين ارتفاع الصف وعرض العمود للخلية B5 وكذلك لف النص الخاص بها
pivotSheet.Cells.SetRowHeight(b5.Row, 100);
pivotSheet.Cells.SetColumnWidth(b5.Column, 65);
Style st = b5.GetStyle();
st.IsTextWrapped = true;
b5.SetStyle(st);

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

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

وأخيرًا، احفظ المصنف الخاص بك بالتغييرات التي أجريتها.

// حفظ المصنف بصيغة xlsx
wb.Save(dataDir + "SpecifyCompatibility_out.xlsx", SaveFormat.Xlsx);

يعد اختيار تنسيق الملف المناسب أمرًا بالغ الأهمية عند حفظ ملفات Excel.Xlsxيتم استخدام التنسيق على نطاق واسع وهو متوافق مع العديد من إصدارات Excel.

خاتمة

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

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

ما هو Aspose.Cells؟

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

لماذا يعد توافق Excel مهمًا؟

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

هل يمكنني إنشاء جداول محورية برمجيًا باستخدام Aspose.Cells؟

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

كيف يمكنني التحقق من طول السلسلة في خلية Excel؟

يمكنك استخدامStringValue ممتلكات شخص ماCell الكائن للحصول على محتوى الخلية ثم استدعاء.Length خاصية لمعرفة طول السلسلة.

هل يمكنني تخصيص تنسيق الخلية بما يتجاوز ارتفاع الصف وعرضه؟

بالتأكيد! يتيح لك Aspose.Cells تنسيق الخلايا على نطاق واسع. يمكنك تغيير أنماط الخطوط والألوان والحدود وتنسيقات الأرقام والمزيد من خلالStyle فصل.

خيار إظهار صفحات تصفية التقارير في .NET تحديد مصدر بيانات الاتصال الخارجي في .NET