الحصول على تنسيق الخلية من ورقة عمل باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud – دليل مفصّل

استخدم هذه واجهة برمجة التطبيقات REST لاسترداد تنسيق خلية في ورقة عمل Excel.

واجهة GetWorksheetCellStyle API

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

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

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

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

اسم المعامل النوع الموقع الوصف
name string path اسم مستند Excel.
sheetName string path اسم ورقة العمل.
cellName string path عنوان الخلية (مثلًا A1).
folder string query المجلد الذي يحتوي على الملف.
storageName string query اسم التخزين المراد استخدامه.

الاستجابة

{
  "Style": {
    "Font": {
      "Color": { "A": 255, "R": 5, "G": 99, "B": 193 },
      "DoubleSize": 11,
      "IsBold": false,
      "IsItalic": false,
      "IsStrikeout": false,
      "IsSubscript": false,
      "IsSuperscript": false,
      "Name": "Calibri",
      "Size": 11,
      "Underline": "Single"
    },
    "Name": null,
    "CultureCustom": "General",
    "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": "/test.xlsx/worksheets/Sheet1/cells/a1/style",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

أكواد حالة HTTP

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

استجابات الخطأ
تتبع حمولات الخطأ النموذجية لهذه النقطة الطرفية التنسيق القياسي لأخطاء Aspose.Cells. على سبيل المثال، يُعيد خطأ 400 Bad Request ما يلي:

{
  "Code": 400,
  "Message": "Invalid parameter 'cellName'.",
  "Description": "The cell name provided is not in a valid A1 format."
}

وبالمثل، يُعيد خطأ 401 Unauthorized ما يلي:

{
  "Code": 401,
  "Message": "Authentication failed.",
  "Description": "The JWT token is missing or invalid."
}

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

مواصفات واجهة GetWorksheetCellStyle API

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

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

مخطط الاستجابة

الحقل النوع الوصف
Style object حاوية تحتوي على جميع خصائص التنسيق الخاصة بالخلية.
Style.Font object إعدادات الخط (الاسم، الحجم، اللون، علامات التنسيق).
Style.Font.Color object قيم لون RGBA لخط الخلية.
Style.Font.IsBold boolean true إذا كان الخط عريضًا (Bold).
Style.Font.IsItalic boolean true إذا كان الخط مائلًا (Italic).
Style.Font.IsStrikeout boolean true إذا كان الخط مُشطوبًا (Strikeout).
Style.Font.IsSubscript boolean true إذا كان الخط منخفضًا (Subscript).
Style.Font.IsSuperscript boolean true إذا كان الخط مرتفعًا (Superscript).
Style.Font.Name string اسم عائلة الخط (مثلًا Calibri).
Style.Font.Size number حجم الخط بالنقاط.
Style.Font.Underline string أسلوب التسطير (مثلًا Single).
Style.IsLocked boolean يشير إلى ما إذا كانت الخلية مُحمية ضد التعديل.
Style.IsTextWrapped boolean true إذا كان تغليف النص مفعّلًا.
Style.IsGradient boolean true إذا تم تطبيق تعبئة متدرجة (Gradient).
Style.Pattern string اسم نمط التعبئة (مثلًا None).
Style.BorderCollection array قائمة كائنات الحدود التي تُعرّف أسلوب الخط، اللون، ونوع الحدود.
Style.BackgroundColor object قيم RGBA لخلفية الخلية.
Style.ForegroundColor object قيم RGBA لمقدمة الخلية.
… … (تتّبع الحقول الأخرى نفس النمط المُعرّف في مرجع API.)

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

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

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

انظر أيضًا

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