إضافة واسترداد البيانات

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

إضافة بيانات إلى الخلايا

توفر Aspose.Cells فئة Workbook التي تمثل ملف Microsoft Excel. تحتوي فئة Workbook على مجموعة Worksheets التي تسمح بالوصول إلى كل ورقة في ملف Excel. يتم تمثيل ورقة عمل بفئة Worksheet. توفر فئة Worksheet مجموعة Cells. يُمثل كل عنصر في مجموعة Cells كائن من فئة Cell.

تسمح Aspose.Cells للمطورين بإضافة بيانات إلى الخلايا في ورق العمل عن طريق استدعاء فئة Cell وطريقة PutValue. توفر Aspose.Cells نسخًا متعددة من طريقة PutValue تتيح للمطورين إضافة أنواع مختلفة من البيانات إلى الخلايا. باستخدام هذه النسخ المتعددة من طريقة PutValue، يُمكن إضافة قيم بوليانية، نصية، عددية، صحيحة أو تاريخ/وقت، إلخ للخلية.

تحسين الكفاءة

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

استرداد البيانات من الخلايا

توفر Aspose.Cells فئة Workbook التي تمثل ملف Microsoft Excel. تحتوي فئة Workbook على مجموعة Worksheets التي تسمح بالوصول إلى ورق العمل في الملف. تمثل ورقة عمل بفئة Worksheet. توفر فئة Worksheet مجموعة Cells. كل عنصر في مجموعة Cells يُمثل كائنًا من فئة Cell.

توفر فئة Cell عدة طرق تسمح للمطورين باسترجاع القيم من الخلايا وفقًا لأنواع بياناتها. تشمل هذه الطرق:

• GetStringValue، تُرجع قيمة السلسلة للخلية.
• GetDoubleValue، تُرجع القيمة العددية للخلية.
• GetBoolValue، يعيد قيمة البيان البوليانية للخلية.
• GetDateTimeValue، يعيد قيمة التاريخ/الوقت للخلية.
• GetFloatValue، يعيد قيمة العدد العائم للخلية.
• GetIntValue، يعيد قيمة العدد الصحيح للخلية.

عندما لا يتم ملؤها، تقوم الخلايا برمي استثناء عند استخدام GetDoubleValue أو GetFloatValue.

يمكن أيضًا التحقق من نوع البيانات الواردة في الخلية باستخدام فئة Cell وطريقة GetType. في الواقع، تعتمد طريقة GetType لفئة Cell على تعداد CellValueType التي قيمها المعرفة مسبقا كما هو مدرج أدناه:

أنواع قيم الخلية	الوصف
CellValueType_IsBool	يحدد أن قيمة الخلية هي منطقية.
CellValueType_IsDateTime	يحدد أن قيمة الخلية هي تاريخ/وقت.
CellValueType_IsNull	يمثل خلية فارغة.
CellValueType_IsNumeric	يحدد أن قيمة الخلية هي رقمية.
CellValueType_IsString	يحدد أن قيمة الخلية هي سلسلة.
CellValueType_IsUnknown	يحدد أن قيمة الخلية مجهولة.
يمكنك أيضًا استخدام أنواع قيم الخلية المعرفة مسبقًا أعلاه للمقارنة مع نوع البيانات الموجودة في كل خلية.