Uppdatera ett listobjekt i ett Excel-ark – Aspose.Cells Cloud API-dokumentation
Denna REST API uppdaterar egenskaperna för ett listobjekt (tabell) i ett Excel-ark.
Säkerhet och autentisering
Aspose.Cells Cloud API:n är säkra och kräver JWT-tokenbaserad autentisering.
Schema för begäran för begäran (Request Body Schema)
DTO:t listObject innehåller följande fält. Endast de fält som du vill ändra behöver inkluderas i begäran.
| Fält | Typ | Obligatoriskt | Beskrivning |
|---|---|---|---|
| DisplayName | sträng | valfritt | Namnet som visas för tabellen. |
| StartRow / StartColumn | heltal | valfritt | Nollbaserat index för första raden/kolumnen i tabellen. |
| EndRow / EndColumn | heltal | valfritt | Nollbaserat index för sista raden/kolumnen i tabellen. |
| Range | sträng | valfritt | A1-stilens adress som definierar tabellintervallet (t.ex. A1:D10). |
| ShowHeaderRow | boolesk värde | valfritt | true för att visa rubrikraden. |
| ShowTotals | boolesk värde | valfritt | true för att visa raden för totalberäkningar. |
| TableStyleName | sträng | valfritt | Namn på den inbyggda tabellstilen som ska tillämpas. |
| TableStyleType | sträng | valfritt | Stiltyp (TableStyleLight, TableStyleMedium, etc.). |
| ListColumns | array av objekt | valfritt | Samling med kolumndefinitioner (Name, TotalsCalculation). |
| Sorter, AutoFilter, ShowTableStyle… | objekt | valfritt | Avancerade stil- och filteralternativ (se fullständig DTO i OpenAPI-specifikationen). |
Minimal exempelnyttolast (payload)
{
"DisplayName": "SalesData",
"Range": "A1:E20",
"ShowHeaderRow": true,
"ShowTotals": false
}
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}
Begärningsparametrar
| Parameternamn | Typ | Plats | Beskrivning |
|---|---|---|---|
| name | sträng | path | Dokumentets namn. |
| sheetName | sträng | path | Arkets namn. |
| listObjectIndex | heltal | path | Index för listobjektet som ska uppdateras. |
| listObject | objekt | body | ListObject DTO i begärandetexten. |
| folder | sträng | query | Mapp som innehåller dokumentet. |
| storageName | sträng | query | Namn på lagringsutrymmet. |
OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.
Begäran
Felaktiga svar (Error Responses)
| HTTP-kod | Beskrivning | Exempel på nyttoinnehåll (payload) |
|---|---|---|
| 400 | Felaktig begäran – obligatoriska fält saknas eller ogiltig JSON. | { "Code": 400, "Message": "Invalid request body." } |
| 401 | Auktorisering misslyckades – JWT-token saknas eller är ogiltig. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | Resursen hittades inte – angivet arbetsbok, ark eller listobjekt saknas. | { "Code": 404, "Message": "Resource not found." } |
| 500 | Internt serverfel – oväntat tillstånd på serversidan. | { "Code": 500, "Message": "Server error." } |
Vanliga frågor (FAQ)
Hur uppdaterar jag ett listobjekt med Aspose.Cells Cloud API?
Använd slutpunkten POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Inkludera en JSON-begäran med de egenskaper du vill ändra (t.ex. DisplayName, ShowHeaderRow). Autentisera med en JWT-token i Authorization-headern.
Vilket svar får jag efter en lyckad uppdatering?
Ett JSON-objekt med Code: 200 och Status: "OK" returneras. Vid ett fel returneras motsvarande HTTP-statuskod och ett Error-objekt som beskriver problemet.
Kan jag uppdatera en delmängd av listobjektets egenskaper?
Ja. Inkludera bara de fält du vill ändra i begärandetexten; alla uteslutna fält förblir oförändrade.
Relaterad dokumentation
Molntjänstfamilj för SDK
Att använda en SDK är det bästa sättet att påskynda utvecklingen. En SDK hanterar detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Besök GitHub-lagringsplatsen för en komplett lista över Aspose.Cells Cloud SDK:n.
Följande kodexempel visar hur man anropar Aspose.Cells webbtjänster med olika SDK:er: