Ottieni Dettagli Colonna

Recupera informazioni dettagliate su una colonna specifica di un foglio di calcolo (indice, larghezza, stile, stato visibilità) da un file Excel memorizzato in Aspose Cloud.

Tabella dei Contenuti

  1. Prerequisiti
  2. Autenticazione
  3. Endpoint
  4. Parametri della Richiesta
  5. Esempio cURL
  6. Esempio di Risposta
  7. Schema di Risposta
  8. Errori Possibili
  9. Esempi SDK
  10. Risorse Aggiuntive

Prerequisiti


Autenticazione

Tutte le API di Aspose.Cells Cloud utilizzano l'autenticazione basata su token JWT. Includi il token nell’intestazione Authorization:

Authorization: Bearer <access_token>

Per maggiori dettagli su come ottenere un token, consulta la guida all’autenticazione.


Endpoint

GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}

Sicurezza e Autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della Richiesta

Nome Posizione Tipo Obbligatorio Descrizione
name path string Nome del file del foglio di calcolo.
sheetName path string Foglio di calcolo contenente la colonna.
columnIndex path integer Indice in base zero della colonna da recuperare.
folder query string No Cartella di archiviazione in cui risiede il foglio di calcolo.
storageName query string No Nome del servizio di archiviazione (ad esempio, Aspose Cloud Storage).

Esempio cURL

curl -X GET "https://api.aspose.cloud/v4.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/0?folder=MyFolder&storageName=MyStorage" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Esempio di Risposta

{
  "Column": {
    "GroupLevel": 0,
    "Index": 0,
    "IsHidden": false,
    "Width": 8.5,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v4.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

Schema di Risposta

Campo Tipo Descrizione
Column.GroupLevel integer Livello di raggruppamento della colonna (utilizzato per il raggruppamento).
Column.Index integer Indice in base zero della colonna.
Column.IsHidden boolean true se la colonna è nascosta; altrimenti false.
Column.Width number Larghezza della colonna espressa in caratteri.
Column.Style object Contiene un link alla risorsa di stile della colonna.
Column.link object Link self alla risorsa della colonna.
Code integer Codice di stato HTTP della risposta.
Status string Descrizione testuale dello stato (ad esempio, OK).

Errori Possibili

Stato HTTP Codice Messaggio Quando si verifica
400 400 Bad Request Parametri obbligatori mancanti o malformati.
401 401 Unauthorized Intestazione Authorization mancante o non valida.
404 404 Not Found Il foglio di calcolo, il foglio di calcolo o la colonna non esistono.
500 500 Internal Server Error Problema imprevisto lato server.

Esempio – 404 Not Found

{
  "Code": 404,
  "Message": "Indice colonna fuori intervallo."
}

Esempio – 401 Unauthorized

{
  "Code": 401,
  "Message": "Token di autenticazione non valido o mancante."
}

Esempi SDK

I frammenti di codice seguenti illustrano come chiamare l’operazione Get Worksheet Columns utilizzando gli SDK ufficiali di Aspose.Cells Cloud. Qualora un Gist non fosse più disponibile, il codice di esempio è fornito direttamente nel blocco.

**C#**
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;
using System;

// Configura il client API
var apiInstance = new CellsApi("client_id", "client_secret");

// Imposta i parametri obbligatori
string name = "test.xlsx";
string sheetName = "Sheet1";
int columnIndex = 0;
string folder = "MyFolder";          // opzionale
string storageName = "MyStorage";    // opzionale

try
{
    var response = apiInstance.GetWorksheetColumns(name, sheetName, columnIndex, folder, storageName);
    Console.WriteLine("Indice colonna: " + response.Column.Index);
    Console.WriteLine("Larghezza: " + response.Column.Width);
}
catch (Exception e)
{
    Console.WriteLine("Eccezione durante la chiamata a CellsApi.GetWorksheetColumns: " + e.Message );
}
**Java**
import com.aspose.cells.cloud.api.CellsApi;
import com.aspose.cells.cloud.model.ColumnsResponse;

public class GetWorksheetColumnsExample {
    public static void main(String[] args) {
        CellsApi apiInstance = new CellsApi("client_id", "client_secret");

        String name = "test.xlsx";
        String sheetName = "Sheet1";
        Integer columnIndex = 0;
        String folder = "MyFolder";          // opzionale
        String storageName = "MyStorage";    // opzionale

        try {
            ColumnsResponse result = apiInstance.getWorksheetColumns(name, sheetName, columnIndex, folder, storageName);
            System.out.println("Indice colonna: " + result.getColumn().getIndex());
            System.out.println("Larghezza: " + result.getColumn().getWidth());
        } catch (Exception e) {
            System.err.println("Eccezione durante la chiamata a CellsApi#getWorksheetColumns");
            e.printStackTrace();
        }
    }
}
**Python**
import asposecellscloudsdk
from asposecellscloudsdk import CellsApi, ApiClient, Configuration

config = Configuration()
config.client_id = "client_id"
config.client_secret = "client_secret"

api_instance = CellsApi(ApiClient(config))

name = "test.xlsx"
sheet_name = "Sheet1"
column_index = 0
folder = "MyFolder"       # opzionale
storage_name = "MyStorage"  # opzionale

try:
    response = api_instance.get_worksheet_columns(name, sheet_name, column_index, folder, storage_name)
    print("Indice colonna:", response.column.index)
    print("Larghezza:", response.column.width)
except Exception as e:
    print("Eccezione durante la chiamata a CellsApi->get_worksheet_columns:", e)
**Node.js (TypeScript)**
import { CellsApi, Configuration } from "@asposecloud/cells-sdk";

const config = new Configuration({
    clientId: "client_id",
    clientSecret: "client_secret"
});
const apiInstance = new CellsApi(config);

const name = "test.xlsx";
const sheetName = "Sheet1";
const columnIndex = 0;
const folder = "MyFolder";       // opzionale
const storageName = "MyStorage"; // opzionale

apiInstance.getWorksheetColumns(name, sheetName, columnIndex, folder, storageName)
    .then((result) => {
        console.log("Indice colonna:", result.column?.index);
        console.log("Larghezza:", result.column?.width);
    })
    .catch((error) => {
        console.error("Errore durante la chiamata a getWorksheetColumns:", error);
    });

Nota: Tutti gli SDK gestiscono automaticamente l’intestazione Authorization dopo aver fornito client_id e client_secret.


Risorse Aggiuntive


Documento aggiornato l’ultima volta il 2026-07-30.