Ein List-Objekt in einem Excel-Arbeitsblatt aktualisieren – Aspose.Cells Cloud API-Dokumentation
Diese REST API aktualisiert die Eigenschaften eines List-Objekts (Tabelle) in einem Excel-Arbeitsblatt.
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Schema des Anforderungstexts
Das DTO listObject enthält die folgenden Felder. Nur die Felder, die Sie ändern möchten, sind im Anforderungstext erforderlich.
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| DisplayName | Zeichenkette (string) | optional | Der für die Tabelle angezeigte Name. |
| StartRow / StartColumn | Ganzzahl (integer) | optional | Nullbasierten Index der ersten Zeile/Spalte der Tabelle. |
| EndRow / EndColumn | Ganzzahl (integer) | optional | Nullbasierten Index der letzten Zeile/Spalte der Tabelle. |
| Range | Zeichenkette (string) | optional | A1-Stil-Adresse, die den Tabellenbereich definiert (z. B. A1:D10). |
| ShowHeaderRow | Boolean (boolean) | optional | true, um die Kopfzeile anzuzeigen. |
| ShowTotals | Boolean (boolean) | optional | true, um die Gesamtzeile anzuzeigen. |
| TableStyleName | Zeichenkette (string) | optional | Name des anzuwendenden integrierten Tabellenstils. |
| TableStyleType | Zeichenkette (string) | optional | Stilart (TableStyleLight, TableStyleMedium, usw.). |
| ListColumns | Array von Objekten | optional | Sammlung von Spaltendefinitionen (Name, TotalsCalculation). |
| Sorter, AutoFilter, ShowTableStyle… | Objekt | optional | Erweiterte Formatierungs- und Filteroptionen (siehe vollständiges DTO in der OpenAPI-Spezifikation). |
Minimales Beispiel für Nutzdaten
{
"DisplayName": "SalesData",
"Range": "A1:E20",
"ShowHeaderRow": true,
"ShowTotals": false
}
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}
Anforderungsparameter
| Parametername | Typ | Speicherort | Beschreibung |
|---|---|---|---|
| name | Zeichenkette (string) | Pfad | Name des Dokuments. |
| sheetName | Zeichenkette (string) | Pfad | Name des Arbeitsblatts. |
| listObjectIndex | Ganzzahl (integer) | Pfad | Index des zu aktualisierenden List-Objekts. |
| listObject | Objekt | Körper (body) | ListObject-DTO im Anforderungstext. |
| folder | Zeichenkette (string) | Abfrage | Ordner, der das Dokument enthält. |
| storageName | Zeichenkette (string) | Abfrage | Name des Speichers. |
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser durchzuführen.
Anforderung
Fehlerantworten
| HTTP-Code | Beschreibung | Beispiel-Nutzdaten |
|---|---|---|
| 400 | Ungültige Anforderung – fehlende erforderliche Felder oder ungültiges JSON. | { "Code": 400, "Message": "Invalid request body." } |
| 401 | Nicht autorisiert – JWT-Token fehlt oder ist ungültig. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | Nicht gefunden – die angegebene Arbeitsmappe, das Arbeitsblatt oder List-Objekt existiert nicht. | { "Code": 404, "Message": "Resource not found." } |
| 500 | Interner Serverfehler – unerwarteter Zustand auf Serverseite. | { "Code": 500, "Message": "Server error." } |
FAQ
Wie aktualisiere ich ein List-Objekt mithilfe der Aspose.Cells Cloud API?
Verwenden Sie den Endpunkt POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Fügen Sie einen JSON-Text mit den Eigenschaften hinzu, die Sie ändern möchten (z. B. DisplayName, ShowHeaderRow). Authentifizieren Sie sich mit einem JWT-Token im Authorization-Header.
Welche Antwort erhalte ich nach einer erfolgreichen Aktualisierung?
Es wird ein JSON-Objekt mit Code: 200 und Status: "OK" zurückgegeben. Bei einem Fehler enthält die Antwort den entsprechenden HTTP-Statuscode und ein Error-Objekt mit einer Beschreibung des Problems.
Kann ich nur eine Teilmenge der List-Objekteigenschaften aktualisieren?
Ja. Geben Sie im Anforderungstext nur die Felder an, die Sie ändern möchten; alle weggelassenen Felder bleiben unverändert.
Verwandte Dokumentation
Cloud SDK-Familie
Die Verwendung eines SDKs ist der beste Weg, um die Entwicklung zu beschleunigen. Ein SDK übernimmt die Details auf unterster Ebene, sodass Sie sich auf Ihre Projekt Aufgaben konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden: