كيفية التعامل مع إمكانية الرؤية في ورقة عمل إكسل

التعامل مع إمكانية الرؤية في ورقة عمل إكسل

تُعرّف إمكانية الرؤية للورقة ما إذا كانت الورقة معروضة للمستخدم النهائي. باستخدام Aspose.Cells Cloud، يمكنك إخفاء أو إظهار ورقة عمل عبر طلب REST بسيط. عناوين نقاط نهاية الواجهة المستخدمة هي:

• إخفاء ورقة عمل – PUT /cells/{fileName}/worksheets/{sheetName}/visibility
• إظهار ورقة عمل – PUT /cells/{fileName}/worksheets/{sheetName}/visibility

إصدار الواجهة المدعوم: v3.0 (حتى مارس 2026)

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

1. حساب نشط لـ Aspose.Cells Cloud.
2. معرف عميل وسر عميل ساري المفعول (أو رمز وصول OAuth 2.0).
3. يجب أن يكون المصنف ({fileName}) قد تم رفعه مسبقًا إلى مساحة التخزين السحابية لـ Aspose.

إخفاء ورقة عمل

الطلب

PUT https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/visibility
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "Visible": false
}

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "Worksheet": {
    "Name": "{sheetName}",
    "Index": 2,
    "Visible": false
  }
}

مثال على cURL

curl -X PUT "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet2/visibility" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{ "Visible": false }'

مثال على .NET SDK

var api = new CellsApi("client_id", "client_secret");
var request = new Visibility { Visible = false };
var response = api.PutWorksheetVisibility("MyWorkbook.xlsx", "Sheet2", request);
Console.WriteLine($"تم إخفاء الورقة: {response.Worksheet.Visible}");

الأخطاء الشائعة

إظهار ورقة عمل

الطلب

PUT https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/visibility
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "Visible": true
}

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "Worksheet": {
    "Name": "{sheetName}",
    "Index": 2,
    "Visible": true
  }
}

مثال على cURL

curl -X PUT "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet2/visibility" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{ "Visible": true }'

مثال على .NET SDK

var api = new CellsApi("client_id", "client_secret");
var request = new Visibility { Visible = true };
var response = api.PutWorksheetVisibility("MyWorkbook.xlsx", "Sheet2", request);
Console.WriteLine($"الورقة مرئية: {response.Worksheet.Visible}");

الأخطاء الشائعة

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

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

الأسئلة الشائعة

كيف أُخفي ورقة عمل باستخدام واجهة Aspose.Cells Cloud API؟

أرسل طلب `PUT` إلى `/cells/{fileName}/worksheets/{sheetName}/visibility` مع جسم JSON `{ "Visible": false }`. تأكد من تضمين رمز وصول OAuth 2.0 ساري المفعول. ستستلم استجابة `200 OK` تحتوي على كائن الورقة المُحدَّث.

ما هي الاستجابة التي أحصل عليها بعد إظهار ورقة عمل؟

تُعيد الواجهة `200 OK` مع حمولة تحتوي على كائن الورقة حيث `"Visible": true`. تحتوي الاستجابة على خصائص الورقة `Name` و`Index` و`Visible`.

هل يمكنني إخفاء عدة ورقات عمل في طلب واحد؟

لا. تعمل نقطة نهاية إمكانية الرؤية على ورقة عمل واحدة فقط مُعرَّفة باسم `{sheetName}`. لإخفاء عدة أوراق، كرّر العملية على كل اسم في كود العميل.

كتبه فريق Aspose Docs – أكثر من 15 عامًا من الخبرة في أتمتة سير عمل إكسل.