Ottenere lo stile di una cella da un foglio di calcolo tramite Aspose.Cells Cloud API – Guida dettagliata

Utilizza questa API REST per recuperare lo stile di una cella in un foglio di calcolo Excel.

GetWorksheetCellStyle API

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione tramite token JWT.

Parametri della richiesta

Nome parametro Tipo Posizione Descrizione
name string path Nome del documento Excel.
sheetName string path Nome del foglio di calcolo.
cellName string path Indirizzo della cella (es. A1).
folder string query Cartella contenente il file.
storageName string query Nome dello storage da utilizzare.

Risposta

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

Codici di stato HTTP

Codice Significato Descrizione
200 OK Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400 Richiesta non valida Parametri mancanti o non validi (es. tipo di file non supportato).
401 Non autorizzato Token JWT non valido o mancante.
413 Payload troppo grande Il file caricato supera il limite di dimensione.
500 Errore interno del server Errore imprevisto sul server.

Risposte di errore
I payload di errore tipici per questo endpoint seguono il formato standard di errore di Aspose.Cells. Ad esempio, un errore 400 Bad Request restituisce:

{
  "Code": 400,
  "Message": "Parametro 'cellName' non valido.",
  "Description": "Il nome della cella fornito non è in un formato A1 valido."
}

Analogamente, un errore 401 Unauthorized restituisce:

{
  "Code": 401,
  "Message": "Autenticazione non riuscita.",
  "Description": "Il token JWT è mancante o non valido."
}

Come utilizzare l’API GetWorksheetCellStyle con gli SDK

Specifica dell’API GetWorksheetCellStyle

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Schema della risposta

Campo Tipo Descrizione
Style object Contenitore per tutte le proprietà relative allo stile della cella.
Style.Font object Impostazioni del font (nome, dimensione, colore, flag di stile).
Style.Font.Color object Valori colore RGBA per il font.
Style.Font.IsBold boolean true se il font è in grassetto.
Style.Font.IsItalic boolean true se il font è in corsivo.
Style.Font.IsStrikeout boolean true se il font è barrato.
Style.Font.IsSubscript boolean true se il font è in pedice.
Style.Font.IsSuperscript boolean true se il font è in apice.
Style.Font.Name string Nome del font (es. Calibri).
Style.Font.Size number Dimensione del font in punti.
Style.Font.Underline string Stile di sottolineatura (es. Single).
Style.IsLocked boolean Indica se la cella è protetta dalla modifica.
Style.IsTextWrapped boolean true se l’incapsulamento del testo è abilitato.
Style.IsGradient boolean true se è applicato un riempimento gradiente.
Style.Pattern string Nome del modello di riempimento (es. None).
Style.BorderCollection array Elenco di oggetti di bordo che definiscono lo stile di linea, il colore e il tipo di bordo.
Style.BackgroundColor object Valori RGBA per lo sfondo della cella.
Style.ForegroundColor object Valori RGBA per il primo piano della cella.
… … (Altri campi seguono lo stesso schema definito nel riferimento API.)

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta la repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Vedi anche

Aggiornare lo stile di più celle – Riferimento API Aspose.Cells Cloud (v3.0)