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

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

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


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

  1. المتطلبات المسبقة
  2. طلب HTTP
  3. المعلمات
  4. مثال باستخدام cURL
  5. الاستجابة
  6. أمثلة لرموز SDK
  7. العمليات ذات الصلة
  8. ملاحظات وقيود

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


طلب 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/ – توثيق عام لنقاط النهاية المتعلقة بالصفوف.

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