Developer-Guide: حذف صفوف متعددة من ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة البرمجية لـ REST بحذف صفوف متعددة من ورقة عمل Excel.

المتطلبات المسبقة: لاستدعاء هذه نقطة النهاية، يجب أن يكون لديك رمز وصول JWT صالح تم الحصول عليه من عملية مصادقة Aspose Cloud، وامتلاك صلاحيات تخزين مناسبة للملف المُستند.

API DeleteWorksheetRows

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows

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

تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud أمانًا عاليًا وتتطلب مصادقة تعتمد على رمز JWT.

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

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
name	string	path	اسم الملف المُستند (workbook).
sheetName	string	path	اسم ورقة العمل (worksheet).
startrow	integer	query	المؤشر الصفر-based للصف الأول المراد حذفه (مثال: `0` = الصف الأول).
totalRows	integer	query	عدد الصفوف المراد حذفها.
updateReference	boolean	query	ما إذا كان سيتم تحديث الإشارات المرجعية بعد الحذف (`true`/`false`).
folder	string	query	مجلد المستند.
storageName	string	query	اسم وحدة التخزين.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows?startrow=1&totalRows=1&updateReference=true" \
-X DELETE \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

رموز الاستجابة المحتملة

حالة HTTP	الوصف
200	تم حذف الصفوف بنجاح.
400	طلب غير صالح – معاملات غير صحيحة.
401	غير مُصادق – رمز JWT مفقود أو غير صالح.
404	غير موجود – الملف أو ورقة العمل غير موجودين.
500	خطأ داخلي في الخادم – حدثت حالة غير متوقعة.

عائلة SDK للسحابة

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

توضح أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

Developer-Guide: حذف صف في ورقة عمل إكسل

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة البرمجية REST بحذف صف من ورقة عمل إكسل.

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

رمز مميز JWT صالح لـ Authorization (المصادقة).
يجب أن يكون ملف المصنف مخزنًا في مساحة تخزين مدعومة من Aspose Cloud (الافتراضية أو المخصصة).
يجب أن تكون المجلد الهدف (إن وُجد) موجودًا في مساحة التخزين المختارة.

واجهة برمجة تطبيقات REST

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

معلمات الطلب

اسم المعلمة	النوع	المسار / الاستعلام	مطلوب	الوصف
name	نص (string)	المسار	نعم	اسم ملف المصنف.
sheetName	نص (string)	المسار	نعم	اسم ورقة العمل.
rowIndex	عدد صحيح	المسار	نعم	الفهرس الصفري (zero-based) للصف المراد حذفه.
startrow	عدد صحيح	الاستعلام	لا	فهرس أول صف ليتم حذفه (عادةً يساوي `rowIndex`).
totalRows	عدد صحيح	الاستعلام	لا	عدد الصفوف المتتالية المراد حذفها.
updateReference	منطقي (boolean)	الاستعلام	لا	عند تعيينها إلى `true` (القيمة الافتراضية)، يتم تحديث الصيغ وال نطاقات المسماة والمرجعيات الأخرى بعد الحذف.
folder	نص (string)	الاستعلام	لا	المجلد الذي يحتوي على ملف المصنف.
storageName	نص (string)	الاستعلام	لا	اسم خدمة التخزين.

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب Aspose.Cells بسهولة. يوضح المثال التالي طلبًا كاملاً قابلًا للتنفيذ.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows?startrow=1&totalRows=1&updateReference=true" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

رموز استجابة HTTP الممكنة

الرمز	المعنى	الوصف
200	OK (تم بنجاح)	تمت عملية حذف الصف بنجاح.
400	Bad Request (طلب غير صالح)	معلمات مفقودة أو غير صالحة (مثل `rowIndex` غير العددي).
401	Unauthorized (غير مخوّل)	رمز JWT غير صالح أو مفقود.
404	Not Found (غير موجود)	ملف المصنف أو ورقة العمل أو الصف المحدد غير موجود.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم؛ راجع استجابة الخطأ للحصول على التفاصيل.

مثال على استجابة خطأ

{
  "Code": 400,
  "Message": "تم تقديم فهرس صف غير صالح."
}

عائلة SDK السحابية

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

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

الطلب

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows?startrow=1&totalRows=1&updateReference=true" \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

العمليات ذات الصلة

Documentation –

Developer-Guide: حذف صفوف متعددة من ورقة عمل Excel

API DeleteWorksheetRows

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

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

عائلة SDK للسحابة

Developer-Guide: حذف صف في ورقة عمل إكسل

واجهة برمجة تطبيقات REST

معلمات الطلب

عائلة SDK السحابية