Zellstil aus einem Arbeitsblatt mit der Aspose.Cells Cloud API abrufen – Detaillierte Anleitung

Verwenden Sie diese REST API, um den Stil einer Zelle in einem Excel-Arbeitsblatt abzurufen.

GetWorksheetCellStyle API

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

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername Typ Ort Beschreibung
name string path Der Name der Excel-Datei.
sheetName string path Der Name des Arbeitsblatts.
cellName string path Die Adresse der Zelle (z. B. A1).
folder string query Der Ordner, der die Datei enthält.
storageName string query Der Name des zu verwendenden Speichers.

Antwort

{
  "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-Statuscodes

Code Bedeutung Beschreibung
200 OK Filter erfolgreich angewendet; Antwort enthält Details zur Operation.
400 Bad Request Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp).
401 Unauthorized Ungültiges oder fehlendes JWT-Token.
413 Payload Too Large Die hochgeladene Datei überschreitet das Größenlimit.
500 Internal Server Error Unerwarteter Serverfehler.

Fehlerantworten
Typische Fehlerantworten für diesen Endpunkt folgen dem standardmäßigen Aspose.Cells-Fehlerformat. Beispielsweise gibt ein 400 Bad Request zurück:

{
  "Code": 400,
  "Message": "Ungültiger Parameter 'cellName'.",
  "Description": "Der angegebene Zellname ist nicht im gültigen A1-Format."
}

Ebenso gibt ein 401 Unauthorized zurück:

{
  "Code": 401,
  "Message": "Authentifizierung fehlgeschlagen.",
  "Description": "Das JWT-Token fehlt oder ist ungültig."
}

Verwendung der GetWorksheetCellStyle API mit SDKs

GetWorksheetCellStyle API-Spezifikation

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie ein Aufruf der Cloud API mit cURL durchgeführt wird.

Antwortschema

Feld Typ Beschreibung
Style object Container für alle stilbezogenen Eigenschaften der Zelle.
Style.Font object Schriftarteinstellungen (Name, Größe, Farbe, Stilflags).
Style.Font.Color object RGBA-Farbwerte für die Schriftart.
Style.Font.IsBold boolean true, wenn die Schriftart fett ist.
Style.Font.IsItalic boolean true, wenn die Schriftart kursiv ist.
Style.Font.IsStrikeout boolean true, wenn die Schriftart durchgestrichen ist.
Style.Font.IsSubscript boolean true, wenn die Schriftart tiefgestellt ist.
Style.Font.IsSuperscript boolean true, wenn die Schriftart hochgestellt ist.
Style.Font.Name string Schriftfamilienname (z. B. Calibri).
Style.Font.Size number Schriftgröße in Punkten.
Style.Font.Underline string Unterstreichungsstil (z. B. Single).
Style.IsLocked boolean Gibt an, ob die Zelle vor Bearbeitung geschützt ist.
Style.IsTextWrapped boolean true, wenn Textumbruch aktiviert ist.
Style.IsGradient boolean true, wenn ein Farbverlaufsfüllmuster angewendet ist.
Style.Pattern string Füllmustername (z. B. None).
Style.BorderCollection array Liste von Randobjekten mit Linienstil, Farbe und Randtyp.
Style.BackgroundColor object RGBA-Werte für den Zellhintergrund.
Style.ForegroundColor object RGBA-Werte für den Zellvordergrund.
… … (Weitere Felder folgen demselben Muster wie in der API-Referenz definiert.)

Verwendung von Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt Details auf niedriger Ebene, sodass Sie sich auf Ihre Projektziele konzentrieren können. Schauen Sie sich das GitHub-Repository für eine vollständige Liste der Aspose.Cells Cloud SDKs an.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mithilfe verschiedener SDKs aufgerufen werden:

Siehe auch

Stil für mehrere Zellen aktualisieren – Aspose.Cells Cloud API Referenz (v3.0)