استيراد وتصدير البيانات
استيراد البيانات إلى ورقة العمل
تمثل البيانات العالم كما هي. لفهم البيانات، نقوم بتحليلها وكسب فهم للعالم. تتحول البيانات إلى معلومات.
هناك العديد من الطرق لإجراء التحليل: وضع البيانات في جداول البيانات وتلاعب بها بطرق مختلفة هي طريقة شائعة. مع Aspose.Cells، من السهل إنشاء جداول بيانات تأخذ البيانات من مجموعة متنوعة من المصادر الخارجية وتعدّها للتحليل.
يناقش هذا المقال بعض تقنيات استيراد البيانات التي يحصل عليها المطورون من خلال Aspose.Cells.
استيراد البيانات باستخدام Aspose.Cells
عند فتح ملف Excel باستخدام Aspose.Cells، يتم استيراد جميع البيانات في الملف تلقائياً. يمكن أيضاً لـ Aspose.Cells استيراد البيانات من مصادر بيانات أخرى:
توفر Aspose.Cells فئة Workbook التي تمثل ملف Excel من مايكروسوفت. تحتوي الفئة Workbook على مجموعة WorksheetCollection التي تسمح بالوصول إلى كل صفحة عمل في ملف Excel. يتم تمثيل صفحة العمل بواسطة الفئة Worksheet. توفر الفئة Worksheet مجموعة Cells. توفر مجموعة Cells طرقا مفيدة جدا لاستيراد البيانات من مصادر بيانات أخرى. يشرح هذا المقال كيفية استخدام هذه الطرق.
الاستيراد من صفيف
لتوريد البيانات إلى جدول بيانات من صفيف، ادعوا طريقة importArray في مجموعة Cells. هناك العديد من الإصدارات المحملة ضعفيا لطريقة importArray ولكن الإصدار النموذجي يأخذ المعلمات التالية:
- مصفوفة، الكائن مصفوفة الذي تقوم باستيراد المحتوى منه.
- رقم الصف، رقم الصف الذي سيتم استيراد البيانات إليه.
- رقم العمود، رقم العمود الذي سيتم استيراد البيانات إليه.
- هَلْ رأسيّ، قيمة بولية تحدد ما إذا كنت ستقوم استيراد البيانات عموديًا أو أفقيًا.
الاستيراد من صفائف متعددة الأبعاد
لتوريد البيانات إلى جدول بيانات من صفائف متعددة الأبعاد، ادعوا طريقة importArray المحملة ضعفيا ذات الصلة في مجموعة Cells:
الاستيراد من ArrayList
لإدخال البيانات من ArrayList إلى أوراق العمل ، يتم استدعاء الأسلوب ImportArrayList في مجموعة Cells. يستغرق الأسلوب ImportArrayList التالية المعلمات التالية:
- الجمعية, ArrayList الذي سيتم توريد محتوياته.
- رقم الصف, رقم الصف الأول لنطاق الخلية من الذي سيتم توريد المحتويات.
- رقم العمود, رقم العمود الأول من الذي سيتم توريد البيانات.
- هل هو عمودي, قيمة بوليانية تحدد ما إذا كان من المناسب توريد البيانات عموديًا أم أفقيًا.
الاستيراد من الكائنات المخصصة إلى منطقة مدمجة
لتوريد البيانات من مجموعة من الكائنات إلى صفحة عمل تحتوي على خلايا مدمجة، استخدم خاصية ImportTableOptions.CheckMergedCells. إذا كان لديك القالب الخاص بإكسل به خلايا مدمجة، ضبط قيمة الخاصية ImportTableOptions.CheckMergedCells على صحيح. قم بتمرير كائن ImportTableOptions مع قائمة الأعمدة/الخصائص إلى الطريقة لعرض القائمة المطلوبة من الكائنات الخاصة بك. يُظهر الكود البرمجي التالي استخدام الخاصية ImportTableOptions.CheckMergedCells لتوريد البيانات من الكائنات المخصصة إلى الخلايا المدمجة. يُرجى الاطلاع على الملف الإكسل المرفق المصدر والملف إكسل الناتج للإحالة.
استيراد البيانات من JSON
توفر Aspose.Cells فئة JsonUtility لمعالجة JSON. تحتوي فئة JsonUtility على طريقة ImportData لاستيراد البيانات ال JSON. كما توفر Aspose.Cells فئة JsonLayoutOptions التي تمثل خيارات تخطيط JSON. الطريقة ImportData تقبل JsonLayoutOptions كمعلمة. توفر الفئة JsonLayoutOptions الخصائص التالية.
- ArrayAsTable: يشير ما إذا كان يجب معالجة الصف في مصفوفة كجدول أم لا.
- ConvertNumericOrDate: يحصل أو يعين قيمة تشير إلى ما إذا كان يجب تحويل السلسلة في JSON إلى رقم أو تاريخ أم لا.
- DateFormat: يحصل ويضبط تنسيق قيمة التاريخ.
- IgnoreArrayTitle: يدل ما إذا كان يتجاهل العنوان في حال كان خصائص الكائن هي مصفوفة.
- IgnoreNull: يشير ما إذا كان يجب تجاهل قيمة الـ Null أم لا.
- IgnoreObjectTitle: يشير ما إذا كان يجب تجاهل العنوان في حال كانت خصائص الكائن هي كائن.
- NumberFormat: يحصل ويضبط تنسيق القيمة الرقمية.
- TitleStyle: يحصل ويضبط نمط العنوان.
يلضح الكود النموذجي المعطى أدناه استخدام فئتي JsonUtility و JsonLayoutOptions لاستيراد بيانات JSON.
تصدير بيانات من ورق العمل
تتيح Aspose.Cells لمستخدميها ليس فقط استيراد البيانات إلى أوراق العمل من مصادر بيانات خارجية ولكنها تسمح أيضًا لهم بتصدير بيانات ورق العمل إلى مصفوفة.
تصدير البيانات باستخدام Aspose.Cells - تصدير البيانات إلى مصفوفة
توفر Aspose.Cells فئة، Workbook، التي تمثل ملف Microsoft Excel. تحتوي الفئة Workbook على WorksheetCollection يسمح بالوصول إلى كل ورق عمل في ملف Excel. يُمثل ورق العمل بواسطة الفئة Worksheet. توفر الفئة Worksheet مجموعة Cells.
يمكن تصدير البيانات بسهولة إلى كائن مصفوفة باستخدام طريقة exportArray لـ فئة Cells.
الأعمدة الحاوية على بيانات مكتوبة بنوعية محددة
تخزن جداول البيانات بيانات كسلسلة من الصفوف والأعمدة. استخدم الطريقة exportArray لتصدير البيانات من ورقة عمل إلى مصفوفة. يأخذ exportArray المعلمات التالية لتصدير بيانات ورقة العمل ككائن مصفوفة:
- رقم الصف، رقم الصف الأول الذي سيتم تصدير البيانات منه.
- رقم العمود، رقم العمود الأول حيث سيتم تصدير البيانات منه.
- عدد الصفوف، عدد الصفوف المراد تصديرها.
- عدد الأعمدة، عدد الأعمدة المراد تصديرها.