الحصول على خصائص الخلايا

يوضح هذا الـ REST API كيفية استرجاع خلية معيّنة في ملف Excel.

واجهة برمجة التطبيقات (REST API)

GET http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/{cellOrMethodName}

الأمان والمصادقة

تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتشترط المصادقة باستخدام رمز JWT.

معاملات الطلب

اسم المعامل النوع الموقع الوصف
name نص (string) المسار (path) اسم ملف Excel.
sheetName نص (string) المسار (path) اسم ورقة العمل التي تحتوي على الخلية.
cellOrMethodName نص (string) المسار (path) اسم الخلية أو اسم طريقة مُعدّة مسبقًا (مثل: firstcell، endcell، maxrow، maxdatarow، maxcolumn، maxdatacolumn، minrow، mindatarow، mincolumn، mindatacolumn).
folder نص (string) الاستعلام (query) المجلد الذي يُخزَّن فيه المستند.
storageName نص (string) الاستعلام (query) اسم خدمة التخزين.

الاستجابة

تُعيد الـ CellResponse.

  • نظرة عامة على حقول الاستجابة
الحقل النوع الوصف
Name نص (string) عنوان الخلية (مثل: F341).
Row عدد صحيح (integer) فهرس الصف بصيغة تبدأ من الصفر.
Column عدد صحيح (integer) فهرس العمود بصيغة تبدأ من الصفر.
Value نص (string) القيمة المعروضة في الخلية.
Type نص (string) نوع البيانات في الخلية (مثل: IsString).
Formula نص (string) نص الصيغة إن كانت الخلية تحتوي على صيغة.
IsFormula منطقي (bool) يُشير إلى ما إذا كانت الخلية تحتوي على صيغة.
IsMerged منطقي (bool) يُشير إلى ما إذا كانت الخلية جزءًا من نطاق مُدمج.
IsArrayHeader منطقي (bool) يُشير إلى ما إذا كانت الخلية رأس مصفوفة.
IsInArray منطقي (bool) يُشير إلى ما إذا كانت الخلية تنتمي إلى مصفوفة.
IsErrorValue منطقي (bool) يُشير إلى ما إذا كانت الخلية تحتوي على قيمة خطأ.
IsInTable منطقي (bool) يُشير إلى ما إذا كانت الخلية داخل جدول.
IsStyleSet منطقي (bool) يُشير إلى ما إذا تم تطبيق نمط على الخلية.
HtmlString نص (string) التمثيل المشفر بـ HTML لقيمة الخلية.
Style.link كائن (object) رابط تشعبي لملف المورد الخاص بالنمط. 
{
  "Status":"OK",
  "Code":200,
  "Cell":{
    "Name":"A1",
    "Row": 0,
    "Column":0,
    "Value": "Hello Aspose.Cells",
    "Type":"String",
    "Formula" : "",
    ...
  }
}

رموز حالة HTTP

الرمز المعنى الوصف
200 ناجح (OK) تمت تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 طلب غير صالح (Bad Request) معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم).
401 غير مصادق عليه (Unauthorized) رمز JWT غير صالح أو مفقود.
413 حجم الحمولة كبير جدًا (Payload Too Large) تجاوز حجم الملف المرفوق الحد المسموح به.
500 خطأ داخلي في الخادم (Internal Server Error) خطأ غير متوقع في الخادم.

كيفية استخدام واجهة GetWorksheetCell API باستخدام مكتبات SDK

مواصفات واجهة GetWorksheetCell API

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول وتتيح لك إجراء تفاعلات REST مباشرةً من متصفّح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء استدعاء إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud

استخدام مكتبة SDK هو أفضل طريقة لتسريع عملية التطوير. فالمكتبة SDK تُجسّد التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.

توضّح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة:

كيفية استرجاع خلية معيّنة

إلغاء دمج الخلايا في ورقة عمل Excel