Fügen Sie eine leere Zeile in ein Excel-Arbeitsblatt mithilfe der Aspose.Cells Cloud API ein

Diese REST API fügt eine neue Zeile in ein Excel-Arbeitsblatt ein. Sie fügt eine leere Zeile am angegebenen nullbasierten Index ein.

Voraussetzungen:

Ein gültiger Aspose Cloud-Zugriffstoken (Bearer JWT) muss im Authorization-Header enthalten sein.
Die Ziel-Arbeitsmappe muss in Ihren Aspose Cloud-Speicher hochgeladen sein, und die Parameter folder und storageName müssen auf ihren Speicherort zeigen.

Hinweise:

Der rowIndex ist nullbasiert; das Einfügen bei Index 0 fügt eine Zeile oben im Arbeitsblatt ein.
Excel-Arbeitsblätter haben maximal 1.048.576 Zeilen; der Versuch, darüber hinaus einzufügen, führt zu einem Fehler.

PutInsertWorksheetRow API

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

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername	Typ	Position	Beschreibung
name	string	path	Der Name der Arbeitsmappen-Datei.
sheetName	string	path	Der Name des Arbeitsblatts.
rowIndex	integer	path	Der nullbasierte Index, an dem die neue Zeile eingefügt wird.
folder	string	query	Der Ordnerpfad im Speicher, in dem sich die Arbeitsmappe befindet.
storageName	string	query	Der Name des zu verwendenden Aspose Cloud-Speichers.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie Aufrufe an die Cloud-API mit cURL durchgeführt werden.

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Hinweis: Alle Aspose.Cells Cloud-Endpunkte erfordern HTTPS. Verwenden Sie für Produktionsaufrufe das sichere Schema https://.

Antwort

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

HTTP-Statuscodes

Code	Bedeutung	Beschreibung
200	OK	Filter erfolgreich angewendet; Antwort enthält Operationsdetails.
400	Bad Request	Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp).
401	Unauthorized	Ungültiger oder fehlender JWT-Token.
413	Payload Too Large	Die hochgeladene Datei überschreitet das Größenlimit.
500	Internal Server Error	Unerwarteter Serverfehler.

Beispiel einer Fehlerantwort (z. B. wenn der Zeilenindex das Arbeitsblatt-Limit überschreitet):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Zeilenindex außerhalb des gültigen Bereichs. Maximal zulässige Zeilen: 1048576."
}

Cloud SDK-Familie

Die Verwendung eines SDKs ist der beste Weg, um die Entwicklung zu beschleunigen. Ein SDK abstrahiert Low-Level-Details und ermöglicht es Ihnen, sich auf Ihre Projektziele zu konzentrieren. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mithilfe verschiedener SDKs aufgerufen werden: