الوصول إلى خلايا ورقة العمل
كيفية الوصول إلى الخلايا
يوفر Aspose.Cells for Node.js via C++ فئة، Workbook تمثل ملف إكسل. تحتوي فئة Workbook على WorksheetCollection تتيح الوصول إلى كل ورقة عمل في ملف إكسل. تمثل ورقة العمل بواسطة فئة Worksheet. توفر فئة Worksheet مجموعة Cells التي تمثل جميع الخلايا في ورقة العمل.
يمكننا استخدام مجموعة Cells للوصول إلى الخلايا في ورقة العمل. يوفر Aspose.Cells for Node.js via C++ ثلاث أساليب أساسية للوصول إلى الخلايا في ورقة العمل:
- باستخدام اسم الخلية.
- باستخدام فهرس صف الخلية والعمود.
- باستخدام فهرس الخلية في Cells المجموعة
مهم: لقد ذكرنا أن النهج الثالث هو الأسرع والنهج الأول هو الأبطأ. الفارق في الأداء بين النهجين صغير جدًا، لذا لا تقلق بشأن تدهور الأداء، أي نهج تختاره.
كيفية الحصول على كائن الخلية باسم الخلية
يمكن للمطورين الوصول إلى أي خلية محددة عن طريق تمرير اسم الخلية إلى Cells المجموعة من فئة Worksheet كفهرس.
إذا قمت بإنشاء ورقة عمل فارغة في البداية، فإن عدد Cells المجموعة هو صفر. عند استخدام هذا النهج للوصول إلى خلية، سيتحقق ما إذا كانت هذه الخلية موجودة في المجموعة أم لا. إذا كانت موجودة، فسيعيد كائن الخلية في المجموعة ، وإلا، سيقوم بإنشاء كائن Cell جديد، يضيف الكائن إلى Cells المجموعة ثم يعيد الكائن. هذا النهج هو أسهل طريقة للوصول إلى الخلية إذا كنت على دراية ببرنامج Microsoft Excel ولكنه الأبطأ مقارنةً بالنهجين الآخرين.
كيفية الحصول على كائن الخلية باستخدام مؤشر صف وعمود الخلية
يمكن للمطورين الوصول إلى أي خلية محددة عن طريق تمرير فهرس صفها وعمودها إلى Cells المجموعة من فئة Worksheet.
يعمل هذا النهج بنفس الطريقة كطريقة الوصول الأولى.
كيفية الحصول على كائن الخلية باستخدام فهرس الخلية في مجموعة الخلايا
يمكن الوصول أيضًا إلى خلية عن طريق تمرير الفهرس الرقمي للخلية إلى Cells المجموعة.
إذا استخدمت هذا النهج للوصول إلى الخلايا، فقد يتم إثارة استثناء إذا كان الفهرس الرقمي للخلية خارج النطاق. هذا النهج هو الأسرع للوصول إلى الخلايا ولكن الشيء الهام لمعرفته هو أنه إذا استخدمت هذا النهج للوصول إلى كائن الخلية، فإن الفهرس الرقمي قد يتغير بعد إضافة خلايا جديدة إلى Cells المجموعة. يتم فرز كائنات الخلايا في Cells المجموعة داخلياً حسب فهارس الصف والعمود.
كيفية الحصول على النطاق الأقصى لعرض ورقة العمل
يتيح Aspose.Cells for Node.js via C++ لنود.js عبر C++ للمطورين الوصول إلى أقصى مدى عرض لورقة العمل. النطاق الأقصى للعرض - هو نطاق الخلايا بين أول وخلية تحتوي على محتوى - مفيد عندما تحتاج إلى نسخ أو تحديد أو عرض المحتويات الكاملة لورقة العمل كصورة.
يمكنك الوصول إلى النطاق الأقصى لعرض ورقة العمل باستخدام Cells.getMaxDisplayRange. يوضح الشيفرة البرمجية النموذجية التالية كيفية الوصول إلى الخاصية getMaxDisplayRange.