تغيير نمط الخلية في ورقة عمل إكسل – دليل واجهة برمجة تطبيقات Aspose.Cells Cloud

تقوم هذه الواجهة البرمجية REST بتحديث نمط الخلية لملف إكسل.

واجهة PostUpdateWorksheetCellStyle البرمجية

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

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

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

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

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم ورقة العمل.
cellName	string	path	الخلية المستهدفة (مثل A1).
style	object	body	كائن JSON يُعرّف إعدادات النمط المطلوب تطبيقها على الخلية.
folder	string	query	المجلد الذي يحتوي على المصنف.
storageName	string	query	اسم وحدة التخزين التي يُخزّن فيها المصنف.

الاستجابة

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

رموز حالة HTTP

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

كيفية استخدام واجهة PostUpdateWorksheetCellStyle البرمجية مع حزم تطوير البرامج (SDKs)

مواصفات واجهة PostUpdateWorksheetCellStyle البرمجية

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. استبدل <jwt token> برمز وصول OAuth 2.0 صالح حصلت عليه من نقطة نهاية مصادقة Aspose Cloud.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/test_cells.xlsx/worksheets/Sheet3/cells/A1/style" \
-d '{ "BackgroundThemeColor": { "ColorType": "Text2", "Tint": 1 } }' \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Response

{
  "Style": {
    "Font": {
      "Color": { "A": 255, "R": 0, "G": 0, "B": 0 },
      "DoubleSize": 11,
      "IsBold": false,
      "IsItalic": false,
      "IsStrikeout": false,
      "IsSubscript": false,
      "IsSuperscript": false,
      "Name": "Calibri",
      "Size": 11,
      "Underline": "None"
    },
    "Name": null,
    "CultureCustom": null,
    "Custom": "",
    "BackgroundColor": { "A": 0, "R": 0, "G": 0, "B": 0 },
    "ForegroundColor": { "A": 0, "R": 0, "G": 0, "B": 0 },
    "IsFormulaHidden": false,
    "IsDateTime": false,
    "IsTextWrapped": false,
    "IsGradient": false,
    "IsLocked": true,
    "IsPercent": false,
    "ShrinkToFit": false,
    "IndentLevel": 0,
    "Number": 0,
    "RotationAngle": 0,
    "Pattern": "None",
    "TextDirection": "Context",
    "VerticalAlignment": "Bottom",
    "HorizontalAlignment": "General",
    "BorderCollection": [
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "BottomBorder" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "DiagonalDown" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "DiagonalUp" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "Horizontal" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "LeftBorder" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "RightBorder" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "TopBorder" },
      { "LineStyle": "None", "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }, "BorderType": "Vertical" }
    ],
    "BackgroundThemeColor": null,
    "ForegroundThemeColor": null,
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/test_cells.xlsx/worksheets/Sheet3/cells/A1/style",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

استخدام حزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud

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

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

انظر أيضًا:

Get Cell Style – استرجاع النمط الحالي للخلية.
Update Multiple Cells Style – تطبيق نمط على مجموعة من الخلايا في طلب واحد.

تحديث أسلوب خلايا متعددة – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 3.0) تطبيق تنسيق نص غني على خلية