Documentation –

Developer-Guide: نسخ الصفوف في ورقة عمل Excel

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

نسخ الصفوف في ورقة عمل Excel v3.0

نسخ البيانات والتنسيقات من صفوف كاملة محددة في ورقة العمل.

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

#	المتطلب
1	رمز JWT صالح. راجع دليل المصادقة.
2	يجب أن يكون ملف المصنف (`{name}`) موجودًا مسبقًا في المجلد / التخزين المُحدَّد.
3	يجب أن تكون ورقة العمل المستهدفة (`{sheetName}`) موجودة في المصنف.
4	(اختياري) معرف المجلد واسم التخزين إن لم يكن الملف في الموقع الافتراضي.

نقطة النهاية

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

جميع معلمات المسار حساسة لحالة الأحرف.

معلمات المسار

المعلمة	النوع	المطلوب	الوصف
`name`	نص	✅	اسم ملف المصنف (مثل `test.xlsx`).
`sheetName`	نص	✅	اسم ورقة العمل (مثل `Sheet1`).

معلمات الاستعلام

المعلمة	النوع	المطلوب	الوصف
`sourceRowIndex`	عدد صحيح	✅	المؤشر بصفر (zero-based) للصف المصدر.
`destinationRowIndex`	عدد صحيح	✅	المؤشر بصفر حيث سيتم وضع الصفوف المنسوخة.
`rowNumber`	عدد صحيح	✅	عدد الصفوف المراد نسخها.
`worksheet`	نص	❌	معرّف ورقة العمل؛ عادةً يساوي sheetName.
`folder`	نص	❌	مسار المجلد الذي يحتوي على المصنف.
`storageName`	نص	❌	اسم خدمة التخزين.

مثال على الطلب (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/copy?sourceRowIndex=1&destinationRowIndex=12&rowNumber=10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

ملاحظة
استبدل <jwt token> برمز JWT صالح تم الحصول عليه من خدمة المصادقة.

الاستجابة الناجحة

الرمز	الوصف
200	تم نسخ الصفوف بنجاح.

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

يحتوي جسم الاستجابة على مثيل من CellsCloudResponse.

معالجة الأخطاء

رمز HTTP	المعنى	مثال على جسم الاستجابة
400	طلب غير صالح – معلمات مفقودة أو غير صحيحة.	`{ "Code": 400, "Message": "Invalid sourceRowIndex." }`
401	غير مصادق عليه – رمز JWT غير صالح أو مفقود.	`{ "Code": 401, "Message": "Authentication failed." }`
404	غير موجود – المصنف أو ورقة العمل غير موجودين.	`{ "Code": 404, "Message": "File not found." }`
500	خطأ داخلي في الخادم – حالة غير متوقعة في الخادم.	`{ "Code": 500, "Message": "An unexpected error occurred." }`

إرشادات المعالجة

400 – تحقق من وجود جميع معلمات الاستعلام المطلوبة وصحتها.
401 – أعد توليد أو حدّث رمز JWT.
404 – تأكد من أسماء المصنف وورقة العمل، وتحقق من وجود الملف في المجلد/التخزين المحدَّد.
500 – أعد المحاولة بعد تأخير قصير؛ إن استمرت المشكلة، تواصل مع دعم Aspose.

أمثلة باستخدام SDKs

توضح المقاطع التالية كيفية استدعاء عملية نسخ الصفوف باستخدام SDKs الرسمية لـ Aspose.Cells Cloud.

اللغة	المثال
C#	عرض الكود `csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar api = new CellsApi("clientId", "clientSecret");\nawait api.PostCopyWorksheetRowsAsync(name: "test.xlsx", sheetName: "Sheet1", sourceRowIndex: 1, destinationRowIndex: 12, rowNumber: 10);\n`
Java	عرض الكود `java\nCellsApi api = new CellsApi("clientId", "clientSecret");\napi.postCopyWorksheetRows("test.xlsx", "Sheet1", 1, 12, 10, null, null, null);\n`
Python	عرض الكود `python\nfrom asposecellscloud import CellsApi\napi = CellsApi(client_id='clientId', client_secret='clientSecret')\napi.post_copy_worksheet_rows(name='test.xlsx', sheet_name='Sheet1', source_row_index=1, destination_row_index=12, row_number=10)\n`
Node.js	عرض الكود `javascript\nconst { CellsApi } = require('asposecellscloud');\nconst api = new CellsApi('clientId', 'clientSecret');\nawait api.postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Go	عرض الكود `go\nimport \"github.com/asposecellscloud/aspose-cells-cloud-go/v3\"\napi := cells.NewCellsApiClient("clientId", "clientSecret")\n_, err := api.PostCopyWorksheetRows(context.Background(), "test.xlsx", "Sheet1", 1, 12, 10, nil, nil, nil)\n`
PHP	عرض الكود `php\nuse Aspose\Cells\CellsApi;\n$api = new CellsApi('clientId', 'clientSecret');\n$api->postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Ruby	عرض الكود `ruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::CellsApi.new('clientId', 'clientSecret')\napi.post_copy_worksheet_rows('test.xlsx', 'Sheet1', 1, 12, 10)\n`
Perl	عرض الكود `perl\nuse Aspose::Cells::CellsApi;\nmy $api = Aspose::Cells::CellsApi->new('clientId', 'clientSecret');\n$api->postCopyWorksheetRows(name => 'test.xlsx', sheetName => 'Sheet1', sourceRowIndex => 1, destinationRowIndex => 12, rowNumber => 10);\n`

تتوفر ملفات المصدر الكاملة في مستودع Aspose‑Cells‑Cloud على GitHub.

انظر أيضًا

تم إنشاء هذه الصفحة في {{DATE}}. للحصول على أحدث إصدار من هذه الواجهة، راجع مواصفات OpenAPI.

Developer-Guide: إخفاء صفوف في ورقة عمل Excel

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

يقوم هذا الـ REST API بإخفاء الصفوف في ورقة عمل Excel.

المتطلبات الأساسية: رمز JWT Bearer ساري المفعول تم الحصول عليه من نقطة نهاية OAuth الخاصة بـ Aspose Cloud، وملف المصنف المخزن في مستودع Aspose Cloud، واسم ورقة العمل التي تحتوي على الصفوف المراد إخفاؤها. يعمل الـ API مع ملفات Excel بصيغ XLS وXLSX وغيرها من الصيغ المدعومة.

PostHideWorksheetRows API

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

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

تُعتبر واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.

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

المعامل	النوع	الموقع	الوصف
name	سلسلة نصية	المسار	اسم ملف المصنف.
sheetName	سلسلة نصية	المسار	اسم ورقة العمل التي تحتوي على الصفوف المراد إخفاؤها.
startrow	عدد صحيح	الاستعلام	المؤشر الصفر-based للصف الأول المراد إخفاؤه.
totalRows	عدد صحيح	الاستعلام	عدد الصفوف المتتالية المراد إخفاؤها، ابتداءً من startrow.
folder	سلسلة نصية	الاستعلام	المجلد في المستودع حيث يوجد المصنف.
storageName	سلسلة نصية	الاستعلام	اسم خدمة التخزين.

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

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

Request

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

Response

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

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

الرمز	الوصف
200	نجاح – تم إخفاء الصفوف
400	طلب غير صالح – معاملات غير صحيحة
401	غير مصرّح به – رمز JWT مفقود أو غير صالح
404	غير موجود – المصنف أو ورقة العمل غير موجودة
500	خطأ في الخادم – فشل في المعالجة الداخلية

تُعيد الاستدعاءات الناجحة كائن JSON يحتوي على الحقلين Code وStatus. وفي حال حدوث خطأ، تتضمن الاستجابة حقول إضافية مثل Message ورموز الحالة HTTP المناسبة (مثل 400، 401، 404، 500).

ملاحظات: تأكد من أن قيمة startrow تقع ضمن نطاق الصفوف في ورقة العمل؛ وإلا فسيُعيد الـ API خطأ 400. وتكون مؤشرات الصفوف صفرية البداية، لذا فإن startrow=0 يشير إلى الصف الأول.

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

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

تعرض مقاطع الكود التالية كيفية إخفاء الصفوف باستخدام مكتبات SDK مختلفة. (تشير أسماء الملفات في الأمثلة إلى “Unhide” بسبب تسمية قديمة؛ بينما يقوم الكود داخل كل مقتطف بتنفيذ عملية Hide.)

Developer-Guide: إظهار الصفوف المخفية في ورقة عمل إكسل

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

تقوم هذه الواجهة (REST API) بإظهار الصفوف المخفية في ورقة عمل إكسل.

المتطلبات المسبقة: احصل على رمز وصول JWT صالح من خدمة مصادقة Aspose Cloud، وتأكد من رفع ملف المصنف المستهدف إلى مساحة تخزين مدعومة قبل استدعاء هذه النقطة النهائية (endpoint).

واجهة PostUnhideWorksheetRows

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

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم المصنف.
sheetName	string	path	اسم ورقة العمل.
startrow	integer	query	المؤشر الصفري (zero-based) للصف الأول المراد إظهاره.
totalRows	integer	query	عدد الصفوف المراد إظهارها.
height	number	query	ارتفاع الصف (القيمة المبدئية: 15.0).
folder	string	query	مجلد المستند.
storageName	string	query	اسم مساحة التخزين.

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

المصادقة
يجب مصادقة جميع الطلبات باستخدام رمز وصول JWT مُستحصل من خدمة مصادقة Aspose Cloud. تضمين الرمز في الرأس Authorization: Bearer <jwt token>.

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/unhide?startrow=1&totalRows=1&height=15" \
 -X POST \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer <jwt token>"
# ملاحظة: جسم الـ POST فارغ لهذه النقطة النهائية

الاستجابة

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

رموز حالة HTTP

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

للحصول على تفاصيل مُعمّقة حول استكشاف الأخطاء وإصلاحها، راجع دليل معالجة الأخطاء.

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

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

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

Developer-Guide: تجميع الصفوف في ورقة عمل Excel

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

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

المتطلبات المسبقة:

يجب تزويدها برمز وصول OAuth 2.0 صالح (Bearer JWT) في الرأس Authorization.
يجب أن تكون المصنف موجودًا مسبقًا في المسار folder المُحدَّد ضمن storageName المختار (أو وحدة التخزين الافتراضية) قبل إرسال الطلب.

واجهة PostGroupWorksheetRows API

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

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

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

معطيات الطلب

اسم المعطى	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم ورقة العمل.
firstIndex	integer	query	المؤشر (بدءًا من الصفر) للصف الأول المطلوب تجميعه.
lastIndex	integer	query	المؤشر (بدءًا من الصفر) للصف الأخير المطلوب تجميعه.
hide	boolean	query	يُشير إلى ما إذا كان يجب إخفاء الصفوف المُجمّعة (`true` أو `false`).
folder	string	query	المسار إلى المجلد الذي يحتوي على المصنف.
storageName	string	query	اسم وحدة التخزين التي يوجد فيها المصنف.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/group?firstIndex=1&lastIndex=2&hide=true" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

الاستجابة

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

رموز حالة HTTP

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

استجابات الخطأ الشائعة:

400 Bad Request – تحقق من أن firstIndex و lastIndex أرقام صحيحة صالحة، وأن firstIndex ≤ lastIndex.
401 Unauthorized – تحقق من أن رأس Authorization يحتوي على رمز JWT ساري المفعول.
404 Not Found – تأكد من وجود المصنف (name) وورقة العمل (sheetName) في المسار folder / storageName المحددين.

انظر أيضًا: فك تجميع الصفوف في ورقة عمل Excel، إخفاء الصفوف في ورقة عمل Excel، إظهار الصفوف المُخفية في ورقة عمل Excel.

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

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

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

Developer-Guide: إلغاء تجميع الصفوف في ورقة عمل Excel

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

تقوم هذه الواجهة البرمجية REST بإلغاء تجميع الصفوف في ورقة عمل Excel.

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

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/ungroup

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

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف العمل (Workbook).
sheetName	string	path	اسم ورقة العمل.
firstIndex	integer	query	الفهرس الصفر-based للصف الأول المراد إلغاء تجميعه.
lastIndex	integer	query	الفهرس الصفر-based للصف الأخير المراد إلغاء تجميعه.
isAll	boolean	query	إذا كانت القيمة true، سيتم إلغاء تجميع جميع الصفوف في النطاق المحدد.
folder	string	query	المجلد الذي يحتوي على ملف العمل.
storageName	string	query	اسم وحدة التخزين التي يقع فيها ملف العمل.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/ungroup?firstIndex=1&lastIndex=5&isAll=true" \
 -X POST \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer <jwt token>"

الاستجابة

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

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

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

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

Developer-Guide: استرجاع صف واحد من ورقة عمل Excel باستخدام API Aspose.Cells Cloud

Thu, 30 Jul 2026 00:00:00 +0000

استرجاع صف واحد من ورقة عمل Excel

النقطة النهائية (Endpoint): GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/rows/{rowIndex}

استرجاع صف من ورقة عمل مخزنة في تخزين Aspose Cloud. تتطلب هذه العملية رمز وصول OAuth 2.0 صالحًا مع نطاق قراءة (Read).

جدول المحتويات

المتطلبات المسبقة

حساب Aspose Cloud مع اشتراك نشط.
رمز وصول OAuth 2.0 يحتوي على نطاق قراءة (Read).
يجب أن يكون المصنف المستهدف موجودًا مسبقًا في تخزين Aspose Cloud.

طلب HTTP

GET /cells/{name}/worksheets/{sheetName}/rows/{rowIndex}?folder={folder}&storageName={storageName} HTTP/1.1
Host: api.aspose.cloud
Authorization: Bearer {access_token}
Accept: application/json

عنوان URL الأساسي: https://api.aspose.cloud/v3.0

المعلمات

المعلمات المسار (Path parameters)

الاسم	النوع	مطلوب	الوصف
`name`	سلسلة نصية (string)	✅	اسم ملف المصنف (مثل `MyWorkbook.xlsx`).
`sheetName`	سلسلة نصية (string)	✅	اسم ورقة العمل (مثل `Sheet1`).
`rowIndex`	عدد صحيح (integer)	✅	الفهرس المبدأ من الصفر (zero-based) للصف المراد استرجاعه.

معلمات الاستعلام (Query parameters) (اختيارية)

الاسم	النوع	مطلوب	الوصف
`folder`	سلسلة نصية (string)	❌	مسار المجلد في التخزين السحابي حيث يوجد المصنف.
`storageName`	سلسلة نصية (string)	❌	اسم خدمة التخزين (في حال استخدام تخزين مخصص).

مثال باستخدام cURL

curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/rows/5?folder=Docs&storageName=MyStorage" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

الاستجابة

مخطط النجاح (`200 OK`)

{
  "Code": 200,
  "Status": "OK",
  "Row": {
    "Index": 5,
    "Height": 15.0,
    "Style": { /* كائن النمط (style object) */ },
    "Cells": [
      { "ColumnIndex": 0, "Value": "A6", "DataType": "String" },
      { "ColumnIndex": 1, "Value": 123, "DataType": "Number" }
      /* ...خلايا إضافية... */
    ]
  }
}

رموز الحالة (Status codes)

الرمز	المعنى
200	تم استرجاع الصف بنجاح.
401	غير مُخوّل (Unauthorized) – رمز الوصول مفقود أو غير صالح.
404	المصنف أو ورقة العمل أو الصف غير موجود.
500	خطأ داخلي في الخادم.

مثال على خطأ (`401 Unauthorized`)

{
  "Code": 401,
  "Message": "رمز الوصول مفقود أو غير صالح."
}

أمثلة لرموز SDK

C#

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var clientId = "YOUR_CLIENT_ID";
var clientSecret = "YOUR_CLIENT_SECRET";

var api = new CellsApi(clientId, clientSecret);
var response = api.CellsRows_GetWorksheetRow(
    name: "MyWorkbook.xlsx",
    sheetName: "Sheet1",
    rowIndex: 5,
    folder: "Docs",
    storageName: null   // اختياري
);

Console.WriteLine($"تم استرجاع الصف {response.Row.Index} مع {response.Row.Cells.Count} خلية.");

Java

import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.model.RowResponse;

CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
RowResponse response = api.cellsRowsGetWorksheetRow(
    "MyWorkbook.xlsx",
    "Sheet1",
    5,
    "Docs",
    null   // storageName – اختياري
);

System.out.println("فهرس الصف: " + response.getRow().getIndex());
System.out.println("عدد الخلايا: " + response.getRow().getCells().size());

Python

from asposecellscloud import CellsApi, ApiException
from asposecellscloud.models import RowResponse

client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

api = CellsApi(client_id, client_secret)

try:
    response = api.cells_rows_get_worksheet_row(
        name="MyWorkbook.xlsx",
        sheet_name="Sheet1",
        row_index=5,
        folder="Docs",
        storage_name=None
    )
    print(f"تم استرجاع الصف {response.row.index} مع {len(response.row.cells)} خلية.")
except ApiException as e:
    print("حدث استثناء عند استدعاء CellsApi->cells_rows_get_worksheet_row:", e)

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

العملية	الوصف
إضافة صف (Add Row)	`POST /cells/{name}/worksheets/{sheetName}/rows` – إدراج صف جديد في ورقة العمل.
حذف صف (Delete Row)	`DELETE /cells/{name}/worksheets/{sheetName}/rows/{rowIndex}` – إزالة صف موجود.
استرجاع صفوف متعددة (Get Multiple Rows)	`GET /cells/{name}/worksheets/{sheetName}/rows` – استرجاع مجموعة من الصفوف.
نظرة عامة على الصفوف (Rows Overview)	`/cells/rows/` – توثيق عام لنقاط النهاية المتعلقة بالصفوف.

ملاحظات وقيود

حد معدل الطلبات: 100 طلب في الدقيقة لكل حساب.
التنسيقات المدعومة: XLS، XLSX، CSV، ODS.
الفهرس الخاص بالصف يبدأ من الصفر (zero-based)، لذا الصف الأول هو 0.
تأكد من تحميل المصنف في المجلد المحدد في folder قبل استدعاء هذه النقطة النهائية.

Developer-Guide:

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

title: “كيفية إضافة صفوف إلى ورقة عمل في إكسل” second_title: “مستند” linktitle: “إضافة” type: docs url: /ar/rows/add/ keywords: “Aspose.Cells, إضافة صفوف, واجهة برمجة تطبيقات إكسل, REST, C#, Java, Python, Node.js” description: “دليل خطوة بخطوة لإضافة صف واحد أو عدة صفوف إلى ورقة عمل في إكسل باستخدام واجهة Aspose.Cells Cloud REST API، مع أمثلة كود مكتوبة بلغات C# و Java و Python و Node.js.” weight: 20 ArticleTitle: “إضافة صفوف إلى ورقة عمل في إكسل باستخدام واجهة Aspose.Cells Cloud API – دليل خطوة بخطوة”

كيفية إضافة صفوف إلى ورقة عمل في إكسل

يشرح هذا المقال كيفية إدراج صف فارغ واحد أو عدة صفوف في ورقة عمل موجودة باستخدام واجهة Aspose.Cells Cloud REST API. تأكد من امتلاك مفتاح API صالح وتنصيب وتهيئة مكتبة SDK المناسبة قبل البدء.

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

حساب Aspose.Cells Cloud مع اشتراك نشط.
مفتاح API / رمز وصول تم إنشاؤه من لوحة تحكم Aspose Cloud.
إحدى مكتبات SDK المدعومة (C# أو Java أو Python أو Node.js) مثبَّتة ومُعدَّة.

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

طريقة HTTP: POST
النهاية (Endpoint): https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/rows
المعلمات المسار المطلوبة:
- fileName – اسم ملف إكسل المخزن في السحابة.
- sheetName – اسم ورقة العمل التي سيتم إضافة الصفوف إليها.
المعلمات الاستعلامية (Query Parameters):
- startrow – الفهرس الصفري للصف الذي يبدأ منه الإدراج.
- totalRows – عدد الصفوف المراد إضافتها.
- folder – (اختياري) مسار المجلد السحابي للملف.
- storage – (اختياري) اسم وحدة التخزين إذا كنت تستخدم وحدة تخزين غير افتراضية.

جسم الطلب (مثال بصيغة JSON):

{
  "startrow": 5,
  "totalRows": 3
}

مثال باستخدام cURL

curl -X POST "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/rows?startrow=5&totalRows=3&folder=MyFolder&storage=MyStorage" \
    -H "Authorization: Bearer {access_token}" \
    -H "Content-Type: application/json" \
    -d '{"startrow":5,"totalRows":3}'

استجابة ناجحة (HTTP 200): تُعيد معلومات ورقة العمل المُحدَّثة، بما في ذلك عدد الصفوف الجديد.
```
{
  "Code": 200,
  "Status": "OK",
  "Worksheet": {
    "Name": "Sheet1",
    "RowsCount": 30
  }
}
```

مثال على استجابة خطأ (HTTP 400):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "معلمة startrow غير صالحة. يجب أن تكون عددًا صحيحًا غير سالب."
}

رموز الحالة (Status Codes):

الرمز	المعنى
200	تمت إضافة الصفوف بنجاح
400	معلمات غير صالحة أو JSON معطّل
401	فشلت عملية المصادقة
404	الملف أو ورقة العمل غير موجودة
500	خطأ في الخادم

فيما يلي روابط سريعة لعرض الأمثلة التفصيلية لإضافة الصفوف:

Developer-Guide:

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

title: “العمل مع حذف الصفوف في ورقة عمل Excel” second_title: “Document” linktitle: “Delete” type: docs url: /rows/delete/ keywords: “Aspose.Cells, حذف صف, Excel API, REST, سحابة, جدول بيانات, Excel, SDK” description: “تعرّف على كيفية حذف صف واحد أو صفوف متعددة في ورقة عمل Excel باستخدام واجهة Aspose.Cells Cloud REST API. يشمل أمثلة كود مكتوبة بلغات Android وC# وGo وJava وNode.js وPerl وPHP وPython وRuby وSwift.” weight: 20 ArticleTitle: “العمل مع حذف الصفوف في ورقة عمل Excel – دليل واجهة Aspose.Cells Cloud API”

عمليات الحذف المتاحة

تُظهر الأمثلة التالية كيفية حذف صف فارغ واحد أو عدة صفوف من ورقة عمل Excel باستخدام واجهة Aspose.Cells Cloud REST API.

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

العنصر	التفاصيل
طريقة HTTP	DELETE
النقطة النهائية (Endpoint)	`/cells/{fileName}/worksheets/{sheetName}/rows`
مُعاملات المسار	`fileName` – اسم ملف Excel (مطلوب) `sheetName` – اسم ورقة العمل (مطلوب)
مُعاملات الاستعلام	`startrow` – فهرس الصف الأول المراد حذفه (مطلوب) `totalRows` – عدد الصفوف المراد حذفها (مطلوب) `storage` – اسم وحدة التخزين السحابية (اختياري) `folder` – مسار المجلد داخل وحدة التخزين (اختياري)
جسم الطلب	لا يوجد
مثال على الاستجابة	`json<br>{<br> "Code": 200,<br> "Status": "OK",<br> "RowsDeleted": 1<br>}<br>`
رموز الحالة الممكنة	200 OK – تم حذف الصفوف بنجاح 400 Bad Request – مُعلمات غير صالحة 401 Unauthorized – فشل المصادقة 404 Not Found – الملف أو ورقة العمل غير موجودة 500 Internal Server Error – مشكلة من جانب الخادم

انظر أيضًا

Documentation –

Developer-Guide: نسخ الصفوف في ورقة عمل Excel

نسخ الصفوف في ورقة عمل Excel v3.0

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

نقطة النهاية

معلمات المسار

معلمات الاستعلام

مثال على الطلب (cURL)

الاستجابة الناجحة

معالجة الأخطاء

أمثلة باستخدام SDKs

انظر أيضًا

Developer-Guide: إخفاء صفوف في ورقة عمل Excel

PostHideWorksheetRows API

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

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

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

Developer-Guide: إظهار الصفوف المخفية في ورقة عمل إكسل

واجهة PostUnhideWorksheetRows

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

معلمات الطلب

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

Developer-Guide: تجميع الصفوف في ورقة عمل Excel

واجهة PostGroupWorksheetRows API

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

معطيات الطلب

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

Developer-Guide: إلغاء تجميع الصفوف في ورقة عمل Excel

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

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

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

Developer-Guide: استرجاع صف واحد من ورقة عمل Excel باستخدام API Aspose.Cells Cloud

استرجاع صف واحد من ورقة عمل Excel

جدول المحتويات

المتطلبات المسبقة

طلب HTTP

المعلمات

المعلمات المسار (Path parameters)

معلمات الاستعلام (Query parameters) (اختيارية)

مثال باستخدام cURL

الاستجابة

مخطط النجاح (200 OK)

رموز الحالة (Status codes)

مثال على خطأ (401 Unauthorized)

أمثلة لرموز SDK

C#

Java

Python

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

ملاحظات وقيود

Developer-Guide:

كيفية إضافة صفوف إلى ورقة عمل في إكسل

Developer-Guide:

عمليات الحذف المتاحة

مخطط النجاح (`200 OK`)

مثال على خطأ (`401 Unauthorized`)