Aggiungi un oggetto elenco (tabella) a un foglio di lavoro Excel – Documentazione di Aspose.Cells Cloud
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: