Documentation –

Developer-Guide: Aggiungi un oggetto elenco (tabella) a un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa REST API aggiunge un oggetto elenco (tabella) a un foglio di lavoro Excel.

Prima di utilizzare questo endpoint, assicurati di disporre di un token JWT valido, che il workbook sia memorizzato in un archivio cloud supportato e che il foglio di lavoro esista.

API REST

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file del workbook.
sheetName	string	path	Nome del foglio di lavoro.
startRow	integer	query	Indice in base zero della prima riga dell’intervallo della tabella.
startColumn	integer	query	Indice in base zero della prima colonna dell’intervallo della tabella.
endRow	integer	query	Indice in base zero dell’ultima riga dell’intervallo della tabella.
endColumn	integer	query	Indice in base zero dell’ultima colonna dell’intervallo della tabella.
hasHeaders	boolean	query	`true` se la prima riga contiene intestazioni di colonna; altrimenti `false`.
listObject	object	body	Definizione dell’oggetto elenco (vedere Schema del corpo della richiesta).
folder	string	query	Cartella contenente il workbook.
storageName	string	query	Nome dell’archivio.

Schema del corpo della richiesta

L’oggetto listObject descrive la tabella che verrà creata. Vengono mostrate solo le proprietà più comuni; per l’elenco completo consultare la specifica OpenAPI.

{
  "displayName": "MiaTabella",
  "showTotals": false,
  "style": "TableStyleMedium2"
}

Esempio di richiesta (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects?startRow=1&startColumn=1&endRow=10&endColumn=12&hasHeaders=true" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "displayName": "MiaTabella",
        "showTotals": false,
        "style": "TableStyleMedium2"
      }'

Risposta di esempio

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

Codici di errore

Stato HTTP	Motivo	Descrizione
400	Richiesta non valida	Parametri di intervallo non validi o corpo JSON malformato.
401	Non autorizzato	Token JWT mancante o scaduto.
404	Non trovato	Il workbook o il foglio di lavoro specificato non esiste.
500	Errore interno del server	Errore imprevisto lato server.

Esempio di risposta 400

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Parametri di intervallo non validi."
}

Esempio di risposta 401

{
  "Code": 401,
  "Status": "Unauthorized",
  "Message": "Il token di autenticazione è mancante o scaduto."
}

La Specifiche OpenAPI forniscono il contratto completo per questa operazione.

Famiglia di SDK cloud

L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello e consente di concentrarsi sui compiti del proprio progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Aggiorna un oggetto elenco in un foglio di calcolo Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa REST API consente di aggiornare le proprietà di un oggetto elenco (tabella) in un foglio di calcolo Excel.

Sicurezza e autenticazione

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

Schema del corpo della richiesta

Il DTO listObject contiene i campi seguenti. Sono richiesti nel corpo della richiesta soltanto i campi che si desidera modificare.

Campo	Tipo	Obbligatorio	Descrizione
DisplayName	stringa	opzionale	Nome visualizzato per la tabella.
StartRow / StartColumn	intero	opzionale	Indice in base zero della prima riga/colonna della tabella.
EndRow / EndColumn	intero	opzionale	Indice in base zero dell’ultima riga/colonna della tabella.
Range	stringa	opzionale	Indirizzo in stile A1 che definisce l’intervallo della tabella (es. `A1:D10`).
ShowHeaderRow	booleano	opzionale	`true` per visualizzare la riga di intestazione.
ShowTotals	booleano	opzionale	`true` per visualizzare la riga dei totali.
TableStyleName	stringa	opzionale	Nome dello stile di tabella predefinito da applicare.
TableStyleType	stringa	opzionale	Tipo di stile (`TableStyleLight`, `TableStyleMedium`, ecc.).
ListColumns	array di oggetti	opzionale	Collezione di definizioni di colonne (`Name`, `TotalsCalculation`).
Sorter, AutoFilter, ShowTableStyle…	oggetto	opzionale	Opzioni avanzate di formattazione e filtraggio (vedere il DTO completo nella specifica OpenAPI).

Payload di esempio minimo

{
  "DisplayName": "SalesData",
  "Range": "A1:E20",
  "ShowHeaderRow": true,
  "ShowTotals": false
}

REST API

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

Parametri della richiesta

Nome del parametro	Tipo	Posizione	Descrizione
name	stringa	path	Nome del documento.
sheetName	stringa	path	Nome del foglio di calcolo.
listObjectIndex	intero	path	Indice dell’oggetto elenco da aggiornare.
listObject	oggetto	body	DTO `ListObject` nel corpo della richiesta.
folder	stringa	query	Cartella contenente il documento.
storageName	stringa	query	Nome dello storage.

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

Richiesta

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet7/listobjects/0" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
    "DisplayName": "SalesData",
    "Range": "A1:E20",
    "ShowHeaderRow": true,
    "ShowTotals": false,
    "ListColumns": [
      { "Name": "Product", "TotalsCalculation": "None" },
      { "Name": "Quantity", "TotalsCalculation": "Sum" },
      { "Name": "Price", "TotalsCalculation": "Average" }
    ]
  }'

Response

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

La risposta in caso di esito positivo include i campi seguenti:

Campo	Tipo	Descrizione
Code	intero	Codice di stato HTTP (200 per successo).
Status	stringa	Descrizione testuale dello stato.
UpdatedObject (opzionale)	oggetto	Rappresentazione dell’`ListObject` aggiornato, contenente i campi modificati.

Risposte di errore

Codice HTTP	Descrizione	Payload di esempio
400	Richiesta non valida – campi obbligatori mancanti o JSON malformato.	`{ "Code": 400, "Message": "Invalid request body." }`
401	Non autorizzato – token JWT mancante o non valido.	`{ "Code": 401, "Message": "Authentication failed." }`
404	Non trovato – il foglio di calcolo, il foglio o l’oggetto elenco specificati non esistono.	`{ "Code": 404, "Message": "Resource not found." }`
500	Errore interno del server – condizione imprevista lato server.	`{ "Code": 500, "Message": "Server error." }`

Domande frequenti (FAQ)

Come aggiorno un oggetto elenco utilizzando l'API Aspose.Cells Cloud?

Utilizzare l’endpoint POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Includere nel corpo JSON le proprietà da modificare (es. DisplayName, ShowHeaderRow). Eseguire l’autenticazione tramite token JWT nell’intestazione Authorization.

Che risposta ricevo dopo un aggiornamento riuscito?

Viene restituito un oggetto JSON con Code: 200 e Status: "OK". In caso di errore, la risposta contiene il codice di stato HTTP appropriato e un oggetto Error che descrive il problema.

Posso aggiornare solo un sottoinsieme delle proprietà dell'oggetto elenco?

Sì. Includere nel corpo della richiesta soltanto i campi che si desidera modificare; tutti gli altri campi rimangono invariati.

Documentazione correlata

Famiglia di SDK cloud

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

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

Developer-Guide: Inserire un filtro di selezione in un oggetto elenco di Excel – Aspose.Cells Cloud API

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST inserisce un filtro di selezione per un oggetto elenco in un foglio di calcolo Excel.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	Stringa	Path	Nome del file Excel.
sheetName	Stringa	Path	Nome del foglio di calcolo contenente l’oggetto elenco.
listObjectIndex	Integer	Path	Indice in base zero dell’oggetto elenco a cui verrà aggiunto il filtro.
columnIndex	Integer	Query	Indice in base zero della colonna su cui si basa il filtro.
destCellName	Stringa	Query	Riferimento alla cella (ad esempio A1) in cui verrà posizionato il filtro.
folder	Stringa	Query	Cartella nello storage contenente il file Excel.
storageName	Stringa	Query	Nome del servizio di storage Aspose Cloud.

È possibile utilizzare lo strumento a riga di comando cURL per chiamare l’API:

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Nota: La richiesta richiede un token bearer JWT valido ottenuto dal servizio di autenticazione Aspose Cloud. Questo endpoint non richiede un corpo di richiesta; inviare un oggetto JSON vuoto {} se la libreria client richiede un payload.

Risposta

{
  "Code": 200,
  "Status": "OK",
  "Slicer": {
    "Name": "Slicer1",
    "ColumnIndex": 2,
    "Position": "A1"
  }
}

Intestazione di risposta: Content-Type: application/json

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 (ad esempio, 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 nel server.

Gestione degli errori

Quando si verifica un errore, l’API restituisce un oggetto JSON contenente un campo ErrorMessage che descrive il problema. Esaminare il codice di stato HTTP e il campo ErrorMessage per determinare l’azione correttiva.

Famiglia di SDK cloud

L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello e consente di concentrarsi sulle attività del proprio progetto. Consultare il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice illustrano come effettuare chiamate ai servizi web Aspose.Cells utilizzando vari SDK:

Developer-Guide: Rimuovi righe duplicate da un ListObject – Documentazione API Aspose.Cells Cloud

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST rimuove le righe duplicate da un ListObject in un foglio di calcolo Excel.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/RemoveDuplicates

Parametri della richiesta

Nome del parametro	Tipo	Posizione	Descrizione
name	Stringa	Path	Il nome del file Excel.
sheetName	Stringa	Path	Il nome del foglio di calcolo contenente l’oggetto elenco.
listObjectIndex	Intero	Path	L’indice in base zero dell’oggetto elenco da elaborare.
folder	Stringa	Query	(Facoltativo) Il percorso della cartella in cui è memorizzato il file.
storageName	Stringa	Query	(Facoltativo) Il nome del servizio di archiviazione.

Esempio di richiesta (cURL)

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/RemoveDuplicates" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

{
  "Code": 200,
  "Status": "OK",
  "DuplicateRowsRemoved": 12,
  "Message": "Le righe duplicate sono state rimosse correttamente."
}

Risposta

In caso di esito positivo, il servizio restituisce un oggetto JSON simile all’esempio precedente. I campi sono:

Code – Codice di stato HTTP (200 per successo).
Status – Descrizione testuale dello stato.
DuplicateRowsRemoved – Numero di righe rimosse.
Message – Ulteriori informazioni sull’operazione.

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 (ad esempio, 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 del server.

Famiglia di SDK Cloud

L’uso 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 il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

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

Developer-Guide: Converti oggetto elenco in intervallo – Aspose.Cells Cloud API

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST converte un oggetto elenco (tabella) in un intervallo all’interno di un foglio di lavoro Excel.

Prerequisiti:
Prima di chiamare l’endpoint, assicurati che il workbook sia caricato nello storage Aspose Cloud, che il foglio di lavoro contenga l’oggetto elenco target e che tu stia usando un formato di file supportato (ad esempio .xlsx, .xlsm).

API REST

Autenticazione
Per chiamare questa operazione devi includere un token JWT valido nell’intestazione Authorization. Ottieni il token inviando una richiesta POST all’endpoint di token OAuth 2.0 con il tuo client ID e client secret. Il token deve includere l’ambito Cells.ReadWrite ed è valido per il periodo restituito dal servizio token.

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/ConvertToRange

Sicurezza e autenticazione

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

Parametri della richiesta

Nome	Tipo	Posizione	Obbligatorio	Predefinito	Descrizione
name	stringa	percorso	Sì	–	Nome del file Excel.
sheetName	stringa	percorso	Sì	–	Nome del foglio di lavoro contenente l’oggetto elenco.
listObjectIndex	intero	percorso	Sì	–	Indice in base zero dell’oggetto elenco (tabella) da convertire.
folder	stringa	query	No	–	Percorso della cartella in cui è memorizzato il file.
storageName	stringa	query	No	–	Nome del servizio di archiviazione.

Nota: Questa operazione funziona solo con formati moderni di Excel come .xlsx e .xlsm. L’oggetto elenco non deve essere protetto. Per ulteriori informazioni sugli oggetti elenco, consulta la panoramica sugli oggetti elenco. Per dettagli sull’uso degli intervalli, consulta la documentazione sugli intervalli.

Esempio cURL (richiesta)

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects/0/ConvertToRange" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your-jwt-token>"

Risposta

{
  "Code": 200,
  "Status": "OK",
  "RangeName": "A1:C10",
  "Address": "Sheet1!A1:C10",
  "FirstRow": 0,
  "FirstColumn": 0,
  "RowCount": 10,
  "ColumnCount": 3
}

Famiglia di SDK Cloud

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

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web Aspose.Cells mediante vari SDK:

Developer-Guide: Ordina i dati di ListObject in un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisiti
Per chiamare questa API è necessario disporre di un token di accesso JWT valido di Aspose Cloud e il file di lavoro deve essere caricato nello storage di Aspose Cloud. Includere l’intestazione Authorization: Bearer <jwt token> in ogni richiesta.

Questa API REST ordina i dati di una tabella in un foglio di lavoro Excel.
Per utilizzare questa operazione, fornire il nome del file di lavoro, il nome del foglio di lavoro e l’indice dell’oggetto ListObject target, insieme a un corpo JSON dataSorter che definisce i criteri di ordinamento.

API PostWorksheetListObjectSortTable

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/sort

Sicurezza e autenticazione

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

Parametri della richiesta

Nome Parametro	Tipo	Path/Query String/HTTPBody	Descrizione
name	string	path	Nome del file Excel archiviato nello storage di Aspose Cloud.
sheetName	string	path	Nome del foglio di lavoro contenente il ListObject.
listObjectIndex	integer	path	Indice in base zero dell’oggetto ListObject (tabella) all’interno del foglio di lavoro.
dataSorter	object	body	Oggetto JSON che specifica le opzioni di ordinamento (es. `CaseSensitive`, `HasHeaders`, `KeyList`, `SortLeftToRight`).
folder	string	query	Percorso della cartella nello storage in cui è situato il file Excel.
storageName	string	query	Nome dello storage di Aspose Cloud.

Note
Il corpo della richiesta deve essere un oggetto JSON valido che corrisponda allo schema dataSorter. Assicurarsi che il file di lavoro, il foglio di lavoro e il ListObject esistano prima di invocare l’operazione di ordinamento.

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

È possibile utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud tramite cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet7/listobjects/1/sort" \
  -X POST \
  -d '{
        "CaseSensitive": true,
        "HasHeaders": true,
        "KeyList": [
          {
            "Key": 1,
            "SortOrder": "Ascending",
            "CustomList": "string"
          }
        ],
        "SortLeftToRight": true
      }' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

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

Codici di stato HTTP

Codice di stato	Descrizione
200	OK – ordinamento completato con successo.
400	Richiesta non valida – parametri non validi.
401	Non autorizzato – autenticazione non riuscita.
404	Non trovato – file di lavoro, foglio di lavoro o ListObject non trovato.
500	Errore interno del server – problema lato server.

Parametri della risposta

Parametro	Tipo	Descrizione
Code	integer	Codice di stato HTTP restituito dall’API.
Status	string	Descrizione testuale del risultato (es. “OK”).

Famiglia di SDK Cloud

Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello e consente di concentrarsi sulle attività del proprio progetto. Consultare il repository GitHub per l’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:

Torna alla panoramica dei ListObjects

Developer-Guide:

Mon, 01 Jan 0001 00:00:00 +0000

title: “Aspose.Cells Cloud API – Ottenere un oggetto elenco (tabella) da un foglio di calcolo” description: “Recuperare un oggetto ListObject (tabella) da un foglio di calcolo Excel utilizzando l’API REST di Aspose.Cells Cloud. Supporta l’esportazione in più formati (PDF, CSV, JSON, …).” keywords:

Aspose.Cells
Cloud API
Excel
ListObject
Table
REST
SDK type: docs slug: /list-objects/get/ weight: 9

Aspose.Cells Cloud API – Ottenere un oggetto elenco (tabella) da un foglio di calcolo

Recuperare un oggetto elenco (noto anche come tabella) da un foglio di calcolo specifico in un file Excel. L’endpoint può esportare direttamente la tabella in un formato scelto, utilizzando il parametro facoltativo format nella query.

Prerequisiti

Requisito	Dettagli
Autenticazione	È richiesto un token JWT (Bearer) valido. Ottenere il token tramite il flusso di autenticazione OAuth2 descritto nella Guida all’autenticazione.
Archiviazione	Il file Excel deve essere memorizzato in una posizione di archiviazione Aspose Cloud. Se il file si trova in un’archiviazione non predefinita, specificare il parametro di query `storageName`.
Limiti di velocità	L’API segue la politica standard di limitazione della velocità di Aspose Cloud (predefinito = 100 richieste/minuto per account).
SDK (opzionali)	Utilizzare uno degli SDK ufficiali (C#, Java, Python, …) semplifica la costruzione delle richieste e la gestione delle risposte. Vedere la sezione Esempi di SDK di seguito.

Richiesta

HTTP GET

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

Parametro	Tipo	Posizione	Obbligatorio	Descrizione
name	`string`	Path	✔️	Nome del file Excel (inclusa l’estensione).
sheetName	`string`	Path	✔️	Foglio di calcolo contenente l’oggetto elenco.
listobjectindex	`integer`	Path	✔️	Indice in base zero dell’oggetto elenco da recuperare.
format	`string`	Query	❌	Format di esportazione desiderato (ad esempio, `pdf`, `csv`, `json`).
folder	`string`	Query	❌	Percorso della cartella in cui è memorizzato il file Excel.
storageName	`string`	Query	❌	Nome dell’archiviazione Aspose Cloud da utilizzare.

Note

Tutte le chiamate devono essere effettuate tramite HTTPS.
Quando il parametro format è fornito, il corpo della risposta è il flusso binario del file esportato (ad esempio, application/pdf).
Senza format, l’API restituisce una descrizione JSON dell’oggetto ListObject.

Esempio cURL

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects/1?format=csv" \
  -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your_jwt_token>"

Sostituire <your_jwt_token> con un JWT valido ottenuto dall’endpoint di autenticazione.

Risposta corretta (JSON)

Quando format non è specificato, l’API restituisce un payload JSON che descrive l’oggetto ListObject.

{
  "ListObject": {
    "AutoFilter": {
      "FilterColumns": [],
      "Range": "B2:F11",
      "Sorter": {
        "CaseSensitive": false,
        "HasHeaders": false,
        "KeyList": [],
        "SortLeftToRight": false
      }
    },
    "DisplayName": "Table3",
    "StartColumn": 1,
    "StartRow": 1,
    "EndColumn": 5,
    "EndRow": 10,
    "ListColumns": [
      {
        "Name": "Column1",
        "Range": {
          "ColumnCount": 1,
          "ColumnWidth": 8.5,
          "FirstColumn": 1,
          "FirstRow": 1,
          "RefersTo": "=Sheet1!$B$2:$B$11",
          "RowCount": 10,
          "RowHeight": 13.5,
          "Worksheet": "Sheet1"
        },
        "TotalsCalculation": "None"
      },
      {
        "Name": "Column2",
        "Range": {
          "ColumnCount": 1,
          "ColumnWidth": 8.5,
          "FirstColumn": 2,
          "FirstRow": 1,
          "RefersTo": "=Sheet1!$C$2:$C$11",
          "RowCount": 10,
          "RowHeight": 13.5,
          "Worksheet": "Sheet1"
        },
        "TotalsCalculation": "None"
      },
      {
        "Name": "Column3",
        "Range": {
          "ColumnCount": 1,
          "ColumnWidth": 8.5,
          "FirstColumn": 3,
          "FirstRow": 1,
          "RefersTo": "=Sheet1!$D$2:$D$11",
          "RowCount": 10,
          "RowHeight": 13.5,
          "Worksheet": "Sheet1"
        },
        "TotalsCalculation": "None"
      },
      {
        "Name": "Column4",
        "Range": {
          "ColumnCount": 1,
          "ColumnWidth": 8.5,
          "FirstColumn": 4,
          "FirstRow": 1,
          "RefersTo": "=Sheet1!$E$2:$E$11",
          "RowCount": 10,
          "RowHeight": 13.5,
          "Worksheet": "Sheet1"
        },
        "TotalsCalculation": "None"
      },
      {
        "Name": "Column5",
        "Range": {
          "ColumnCount": 1,
          "ColumnWidth": 8.5,
          "FirstColumn": 5,
          "FirstRow": 1,
          "RefersTo": "=Sheet1!$F$2:$F$11",
          "RowCount": 10,
          "RowHeight": 13.5,
          "Worksheet": "Sheet1"
        },
        "TotalsCalculation": "None"
      }
    ],
    "ShowHeaderRow": true,
    "ShowTableStyleColumnStripes": false,
    "ShowTableStyleFirstColumn": false,
    "ShowTableStyleLastColumn": false,
    "ShowTableStyleRowStripes": true,
    "ShowTotals": false,
    "TableStyleName": "None",
    "TableStyleType": "None",
    "link": {
      "Href": "api-qa.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

Quando format è fornito, il corpo della risposta è un flusso binario del tipo di file richiesto (ad esempio, Content-Type: text/csv).

Gestione degli errori

Codice HTTP	Significato	Esempio JSON
400	Richiesta non valida – parametri mancanti o non validi.	`{"Code":400,"Message":"Parametro format non valido."}`
401	Non autorizzato – token JWT mancante o non valido.	`{"Code":401,"Message":"Autenticazione non riuscita."}`
404	Non trovato – il file Excel, il foglio di calcolo o l’oggetto elenco non esistono.	`{"Code":404,"Message":"ListObject non trovato."}`
500	Errore interno del server.	`{"Code":500,"Message":"Errore imprevisto del server."}`

Errori comuni (note)

Indice in base zero – listobjectindex inizia da 0. Una richiesta con indice 1 restituisce la seconda tabella nel foglio.
Cartella e archiviazione – Se il file Excel è memorizzato in una sottocartella, includere il parametro di query folder (ad esempio, ?folder=Reports/2024).
Formato di esportazione – Sono ammessi solo i formati supportati dal motore di conversione di Aspose.Cells (pdf, xlsx, csv, json, …). Fornire un valore non supportato genera un errore 400.

Esempi di SDK

I frammenti seguenti mostrano come chiamare l’endpoint utilizzando gli SDK ufficiali di Aspose.Cells Cloud. Sostituire i valori segnaposto (<YOUR_CLIENT>, <YOUR_JWT>, ecc.) con la propria configurazione effettiva.

💻 C#

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model.Requests;

// Inizializzare il client API
var apiInstance = new ListObjectsApi();

// Costruire la richiesta
var request = new GetWorksheetListObjectRequest(
    name: "Book1.xlsx",
    sheetName: "Sheet1",
    listobjectindex: 1,
    format: null,               // ad esempio, "csv" per esportare
    folder: null,
    storageName: null
);

// Eseguire
var response = apiInstance.GetWorksheetListObject(request);
Console.WriteLine(response);

☕ Java

import com.aspose.cells.cloud.api.ListObjectsApi;
import com.aspose.cells.cloud.model.*;
import com.aspose.cells.cloud.model.requests.*;

public class GetWorksheetListObjectExample {
    public static void main(String[] args) throws ApiException {
        ListObjectsApi apiInstance = new ListObjectsApi();

        GetWorksheetListObjectRequest request = new GetWorksheetListObjectRequest(
                "Book1.xlsx",   // name
                "Sheet1",       // sheetName
                1,              // listobjectindex
                null,           // format
                null,           // folder
                null            // storageName
        );

        ListObjectResponse result = apiInstance.getWorksheetListObject(request);
        System.out.println(result);
    }
}

🐍 Python

from asposecellscloud.apis.list_objects_api import ListObjectsApi
from asposecellscloud.models import GetWorksheetListObjectRequest

api = ListObjectsApi()

request = GetWorksheetListObjectRequest(
    name="Book1.xlsx",
    sheet_name="Sheet1",
    listobjectindex=1,
    format=None,
    folder=None,
    storage_name=None
)

response = api.get_worksheet_list_object(request)
print(response)

🟢 Node.js (TypeScript)

import { ListObjectsApi, GetWorksheetListObjectRequest } from "@asposecellscloud/asposecellscloud";

const api = new ListObjectsApi();

const request = new GetWorksheetListObjectRequest({
    name: "Book1.xlsx",
    sheetName: "Sheet1",
    listobjectindex: 1,
    format: undefined,
    folder: undefined,
    storageName: undefined
});

api.getWorksheetListObject(request)
   .then(response => console.log(response))
   .catch(err => console.error(err));

🐘 PHP

<?php
require_once(__DIR__ . '/vendor/autoload.php');

use Aspose\Cells\Cloud\Api\ListObjectsApi;
use Aspose\Cells\Cloud\Model\Requests\GetWorksheetListObjectRequest;

$listObjectsApi = new ListObjectsApi();

$request = new GetWorksheetListObjectRequest(
    "Book1.xlsx",   // name
    "Sheet1",       // sheetName
    1,              // listobjectindex
    null,           // format
    null,           // folder
    null            // storageName
);

$response = $listObjectsApi->getWorksheetListObject($request);
print_r($response);
?>

💎 Ruby

require 'aspose_cells_cloud'

api_instance = AsposeCellsCloud::ListObjectsApi.new

request = AsposeCellsCloud::GetWorksheetListObjectRequest.new(
  name: 'Book1.xlsx',
  sheet_name: 'Sheet1',
  listobjectindex: 1,
  format: nil,
  folder: nil,
  storage_name: nil
)

result = api_instance.get_worksheet_list_object(request)
puts result

🦪 Go

package main

import (
    "fmt"
    cells "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"
    "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3/api"
)

func main() {
    cfg := cells.NewConfiguration()
    cfg.AddDefaultHeader("Authorization", "Bearer <your_jwt>")
    client := api.NewAPIClient(cfg)

    request := api.GetWorksheetListObjectRequest{
        Name:            "Book1.xlsx",
        SheetName:       "Sheet1",
        Listobjectindex: 1,
        Format:          nil,
        Folder:          nil,
        StorageName:     nil,
    }

    result, _, err := client.ListObjectsApi.GetWorksheetListObject(request)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    fmt.Printf("%+v\n", result)
}

Vedere anche

Endpoint correlato	Descrizione
Aggiungi ListObject	`POST /cells/{name}/worksheets/{sheetName}/listobjects` – crea una nuova tabella.
Aggiorna ListObject	`PUT /cells/{name}/worksheets/{sheetName}/listobjects/{listobjectindex}` – modifica le proprietà della tabella.
Elimina ListObject	`DELETE /cells/{name}/worksheets/{sheetName}/listobjects/{listobjectindex}` – rimuove una tabella.
Elenca tutti i ListObject	`GET /cells/{name}/worksheets/{sheetName}/listobjects` – enumera le tabelle in un foglio di calcolo.

Riferimenti

Specifica OpenAPI – https://apireference.aspose.cloud/cells/#/ListObjects/GetWorksheetListObject
Guida all’autenticazione – https://docs.aspose.cloud/cells/authentication/
Repository GitHub (SDK) – https://github.com/aspose-cells-cloud

Documentation –

Developer-Guide: Aggiungi un oggetto elenco (tabella) a un foglio di lavoro Excel

API REST

Parametri della richiesta

Schema del corpo della richiesta

Esempio di richiesta (cURL)

Risposta di esempio

Codici di errore

Famiglia di SDK cloud

Developer-Guide: Aggiorna un oggetto elenco in un foglio di calcolo Excel

Sicurezza e autenticazione

Schema del corpo della richiesta

Payload di esempio minimo

REST API

Parametri della richiesta

Richiesta

Risposte di errore

Domande frequenti (FAQ)

Documentazione correlata

Famiglia di SDK cloud

Developer-Guide: Inserire un filtro di selezione in un oggetto elenco di Excel – Aspose.Cells Cloud API

API REST

Parametri della richiesta

Gestione degli errori

Famiglia di SDK cloud

Developer-Guide: Rimuovi righe duplicate da un ListObject – Documentazione API Aspose.Cells Cloud

API REST

Parametri della richiesta

Esempio di richiesta (cURL)

Risposta

Famiglia di SDK Cloud

Developer-Guide: Converti oggetto elenco in intervallo – Aspose.Cells Cloud API

API REST

Sicurezza e autenticazione

Parametri della richiesta

Esempio cURL (richiesta)

Famiglia di SDK Cloud

Developer-Guide: Ordina i dati di ListObject in un foglio di lavoro Excel

API PostWorksheetListObjectSortTable

Sicurezza e autenticazione

Parametri della richiesta

Famiglia di SDK Cloud

Developer-Guide:

Aspose.Cells Cloud API – Ottenere un oggetto elenco (tabella) da un foglio di calcolo

Prerequisiti

Richiesta

HTTP GET

Note

Esempio cURL

Risposta corretta (JSON)

Gestione degli errori

Errori comuni (note)

Esempi di SDK

Vedere anche

Riferimenti

HTTP GET