Documentation –

Developer-Guide: So fügen Sie Zeilen zu einem Excel-Arbeitsblatt hinzu

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

So fügen Sie Zeilen zu einem Excel-Arbeitsblatt hinzu

Dieser Artikel erklärt, wie Sie mithilfe der Aspose.Cells Cloud REST API eine einzelne leere Zeile oder mehrere Zeilen in ein bestehendes Arbeitsblatt einfügen. Stellen Sie sicher, dass Sie über einen gültigen API-Schlüssel und das entsprechende SDK verfügen, bevor Sie beginnen.

Voraussetzungen

Aspose.Cells Cloud-Konto mit aktiver Subscription.
API-Schlüssel / Zugriffstoken, das aus dem Aspose Cloud-Dashboard generiert wurde.
Eines der unterstützten SDKs (C#, Java, Python, Node.js) installiert und konfiguriert.

API-Referenz

HTTP-Methode: POST
Endpunkt: https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/rows
Erforderliche Pfadparameter:
- fileName – Name der Excel-Datei, die in der Cloud gespeichert ist.
- sheetName – Name des Arbeitsblatts, zu dem die Zeilen hinzugefügt werden sollen.
Abfrageparameter:
- startrow – Nullbasiert Index der Zeile, ab der die Einfügung beginnt.
- totalRows – Anzahl der einzufügenden Zeilen.
- folder – (Optional) Cloud-Ordnerpfad der Datei.
- storage – (Optional) Speichername, wenn ein nicht-standardmäßiger Speicher verwendet wird.

Anforderungstext (JSON-Beispiel):

{
  "startrow": 5,
  "totalRows": 3
}

cURL-Beispiel

curl -X POST "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/rows?startrow=5&totalRows=3&folder=MyFolder&storage=MyStorage" \
    -H "Authorization: Bearer {access_token}" \
    -H "Content-Type: application/json" \
    -d '{"startrow":5,"totalRows":3}'

Erfolgreiche Antwort (HTTP 200): Gibt die aktualisierten Informationen des Arbeitsblatts zurück, einschließlich der neuen Zeilenzahl.
```
{
  "Code": 200,
  "Status": "OK",
  "Worksheet": {
    "Name": "Sheet1",
    "RowsCount": 30
  }
}
```

Fehlerantwortbeispiel (HTTP 400):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Ungültiger startrow-Parameter. Dieser muss eine nichtnegative Ganzzahl sein."
}

Statuscodes:

Code	Bedeutung
200	Zeilen erfolgreich hinzugefügt
400	Ungültige Parameter oder fehlerhaftes JSON
401	Authentifizierung fehlgeschlagen
404	Datei oder Arbeitsblatt nicht gefunden
500	Serverfehler

Nachfolgend finden Sie Kurzlinks zu den detaillierten Beispielen zum Hinzufügen von Zeilen:

Developer-Guide: Arbeiten mit dem Löschen von Zeilen in einem Excel-Arbeitsblatt

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

Verfügbare Löschvorgänge

Die folgenden Beispiele zeigen, wie Sie mithilfe der Aspose.Cells Cloud REST API eine einzelne leere Zeile oder mehrere Zeilen aus einem Excel-Arbeitsblatt löschen.

API-Referenz

Element	Details
HTTP-Methode	DELETE
Endpunkt	`/cells/{fileName}/worksheets/{sheetName}/rows`
Pfadparameter	`fileName` – Name der Excel-Datei (erforderlich) `sheetName` – Name des Arbeitsblatts (erforderlich)
Abfrageparameter	`startrow` – Index der ersten zu löschenden Zeile (erforderlich) `totalRows` – Anzahl der zu löschenden Zeilen (erforderlich) `storage` – Name des Cloud-Speichers (optional) `folder` – Ordnerpfad im Speicher (optional)
Anforderungstext	Keiner
Antwortbeispiel	`json<br>{<br> "Code": 200,<br> "Status": "OK",<br> "RowsDeleted": 1<br>}<br>`
Mögliche Statuscodes	200 OK – Zeilen erfolgreich gelöscht 400 Bad Request – ungültige Parameter 401 Unauthorized – Authentifizierungsfehler 404 Not Found – Datei oder Arbeitsblatt nicht gefunden 500 Internal Server Error – serverseitiges Problem

Siehe auch

Developer-Guide: Zeilen auf einem Excel-Arbeitsblatt kopieren

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

Zeilen auf einem Excel-Arbeitsblatt kopieren v3.0

Kopieren Sie Daten und Formatierungen von spezifischen, ganzen Zeilen in einem Arbeitsblatt.

Voraussetzungen

#	Anforderung
1	Ein gültiges JWT-Token. Siehe Authentifizierungsanleitung.
2	Die Arbeitsmappe (`{name}`) muss bereits im ausgewählten Ordner / Speicher vorhanden sein.
3	Das Zielarbeitsblatt (`{sheetName}`) muss in der Arbeitsmappe vorhanden sein.
4	(Optional) Kenntnis des Ordners und des storageName, falls sich die Datei nicht am Standardort befindet.

Endpunkt

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

Alle Pfadparameter unterscheiden zwischen Groß- und Kleinschreibung.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
`name`	string	✅	Dateiname der Arbeitsmappe (z. B. `test.xlsx`).
`sheetName`	string	✅	Name des Arbeitsblatts (z. B. `Sheet1`).

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`sourceRowIndex`	integer	✅	Nullbasierten Index der Quellzeile.
`destinationRowIndex`	integer	✅	Nullbasierter Index, an dem die Zeilen eingefügt werden sollen.
`rowNumber`	integer	✅	Anzahl der zu kopierenden Zeilen.
`worksheet`	string	❌	Bezeichner des Arbeitsblatts; üblicherweise identisch mit sheetName.
`folder`	string	❌	Pfad zum Ordner, der die Arbeitsmappe enthält.
`storageName`	string	❌	Name des Speicherdiensts.

Anforderungsbeispiel (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/copy?sourceRowIndex=1&destinationRowIndex=12&rowNumber=10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Hinweis
Ersetzen Sie <jwt token> durch ein gültiges JWT-Token, das Sie vom Authentifizierungsdienst erhalten haben.

Erfolgreiche Antwort

Code	Beschreibung
200	Zeilen erfolgreich kopiert.

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

Der Antworttext ist eine Instanz von CellsCloudResponse.

Fehlerbehandlung

HTTP-Code	Bedeutung	Beispiel-Antworttext
400	Ungültige Anforderung – fehlende/ungültige Parameter.	`{ "Code": 400, "Message": "Invalid sourceRowIndex." }`
401	Nicht autorisiert – ungültiges oder fehlendes JWT-Token.	`{ "Code": 401, "Message": "Authentication failed." }`
404	Nicht gefunden – Arbeitsmappe oder Arbeitsblatt existiert nicht.	`{ "Code": 404, "Message": "File not found." }`
500	Interner Serverfehler – unerwarteter Serverzustand.	`{ "Code": 500, "Message": "An unexpected error occurred." }`

Richtlinien zur Fehlerbehandlung

400 – Stellen Sie sicher, dass alle erforderlichen Abfrageparameter vorhanden sind und korrekt formatiert wurden.
401 – Generieren Sie das JWT-Token neu oder aktualisieren Sie es.
404 – Überprüfen Sie die Namen von Arbeitsmappe und Arbeitsblatt sowie die Existenz der Datei im angegebenen Ordner bzw. Speicher.
500 – Wiederholen Sie den Vorgang nach kurzer Verzögerung; falls das Problem bestehen bleibt, wenden Sie sich an den Aspose-Support.

SDK-Beispiele

Die folgenden Codeausschnitte zeigen, wie der Vorgang Copy Rows mit den offiziellen Aspose.Cells Cloud SDKs aufgerufen wird.

Sprache	Beispiel
C#	Code anzeigen `csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar api = new CellsApi("clientId", "clientSecret");\nawait api.PostCopyWorksheetRowsAsync(name: "test.xlsx", sheetName: "Sheet1", sourceRowIndex: 1, destinationRowIndex: 12, rowNumber: 10);\n`
Java	Code anzeigen `java\nCellsApi api = new CellsApi("clientId", "clientSecret");\napi.postCopyWorksheetRows("test.xlsx", "Sheet1", 1, 12, 10, null, null, null);\n`
Python	Code anzeigen `python\nfrom asposecellscloud import CellsApi\napi = CellsApi(client_id='clientId', client_secret='clientSecret')\napi.post_copy_worksheet_rows(name='test.xlsx', sheet_name='Sheet1', source_row_index=1, destination_row_index=12, row_number=10)\n`
Node.js	Code anzeigen `javascript\nconst { CellsApi } = require('asposecellscloud');\nconst api = new CellsApi('clientId', 'clientSecret');\nawait api.postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Go	Code anzeigen `go\nimport \"github.com/asposecellscloud/aspose-cells-cloud-go/v3\"\napi := cells.NewCellsApiClient(\"clientId\", \"clientSecret\")\n_, err := api.PostCopyWorksheetRows(context.Background(), \"test.xlsx\", \"Sheet1\", 1, 12, 10, nil, nil, nil)\n`
PHP	Code anzeigen `php\nuse Aspose\Cells\CellsApi;\n$api = new CellsApi('clientId', 'clientSecret');\n$api->postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Ruby	Code anzeigen `ruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::CellsApi.new('clientId', 'clientSecret')\napi.post_copy_worksheet_rows('test.xlsx', 'Sheet1', 1, 12, 10)\n`
Perl	Code anzeigen `perl\nuse Aspose::Cells::CellsApi;\nmy $api = Aspose::Cells::CellsApi->new('clientId', 'clientSecret');\n$api->postCopyWorksheetRows(name => 'test.xlsx', sheetName => 'Sheet1', sourceRowIndex => 1, destinationRowIndex => 12, rowNumber => 10);\n`

Vollständige Quellcode-Dateien finden Sie im Aspose‑Cells‑Cloud GitHub-Repository.

Siehe auch

Seite erstellt am {{DATE}}. Für die neueste Version dieser API siehe die OpenAPI-Spezifikation.

Developer-Guide: Zeilen in einem Excel-Arbeitsblatt ausblenden

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

Diese REST-API blendet Zeilen in einem Excel-Arbeitsblatt aus.

Voraussetzungen: Ein gültiges JWT-Bearer-Token, das vom Aspose Cloud OAuth-Endpunkt abgerufen wurde; die Arbeitsmappe ist im Aspose Cloud-Speicher gespeichert; sowie der Name des Arbeitsblatts, das die auszublendenden Zeilen enthält. Die API funktioniert mit Excel-Dateien in den Formaten XLS, XLSX und weiteren unterstützten Formaten.

PostHideWorksheetRows API

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

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parameter	Typ	Position	Beschreibung
name	string	path	Der Name der Arbeitsmappen-Datei.
sheetName	string	path	Der Name des Arbeitsblatts, das die auszublendenden Zeilen enthält.
startrow	integer	query	Nullbasierter Index der ersten auszublendenden Zeile.
totalRows	integer	query	Die Anzahl aufeinanderfolgender Zeilen, die ab startrow ausgeblendet werden sollen.
folder	string	query	Der Ordner im Speicher, in dem sich die Arbeitsmappe befindet.
storageName	string	query	Der Name des Speicherdienstes.

Die OpenAPI-Spezifikation stellt eine öffentlich zugängliche Programmierschnittstelle bereit, mit der Sie REST-Interaktionen direkt aus einem Webbrowser heraus durchführen können.

Sie können das Kommandozeilentool cURL verwenden, um Aspose.Cells-Webdienste aufzurufen. Die API erfordert ein JWT-Bearer-Token, das vom Aspose Cloud OAuth-Endpunkt abgerufen wurde; dieses muss im Authorization-Header übermittelt werden. Das folgende Beispiel zeigt, wie eine Zeile mit cURL ausgeblendet wird.

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/hide?startrow=1&totalRows=1" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Antwort

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

HTTP-Statuscodes der Antwort

Code	Beschreibung
200	Erfolg – Zeilen ausgeblendet
400	Ungültige Anforderung – ungültige Parameter
401	Nicht autorisiert – fehlendes oder ungültiges JWT
404	Nicht gefunden – Arbeitsmappe oder Arbeitsblatt existiert nicht
500	Serverfehler – interner Verarbeitungsfehler

Ein erfolgreicher Aufruf gibt ein JSON-Objekt zurück, das die Felder Code und Status enthält. Im Fehlerfall enthält die Antwort zusätzliche Felder wie Message sowie entsprechende HTTP-Statuscodes (z. B. 400, 401, 404, 500).

Hinweise: Stellen Sie sicher, dass der Wert von startrow innerhalb des Zeilenbereichs des Arbeitsblatts liegt; andernfalls gibt die API einen Fehler mit Statuscode 400 zurück. Zeilenindizes sind nullbasiert, d. h. startrow=0 bezieht sich auf die erste Zeile.

Cloud SDK-Familie

Die Verwendung eines SDKs ist die schnellste Möglichkeit, diese Funktionalität in Ihre Anwendung zu integrieren. SDKs übernehmen die Details auf niedriger Ebene, sodass Sie sich auf Ihre Geschäftslogik konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Die folgenden Codebeispiele zeigen, wie Zeilen mithilfe verschiedener SDKs ausgeblendet werden. (Die Beispieldateinamen beziehen sich aus historischen Gründen auf „Unhide“, der Code innerhalb jedes Gists führt jedoch die Hide-Operation aus.)

Developer-Guide: Zeilen in einem Excel-Arbeitsblatt einblenden

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

Diese REST API blendet Zeilen in einem Excel-Arbeitsblatt wieder ein.

Voraussetzungen: Holen Sie sich ein gültiges JWT-Zugriffstoken vom Aspose-Cloud-Authentifizierungsdienst und stellen Sie sicher, dass die Zielarbeitsmappe vor dem Aufrufen dieses Endpunkts in einem unterstützten Speicher hochgeladen wurde.

PostUnhideWorksheetRows API

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

Sicherheit und Authentifizierung

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

Anfrageparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Der Name der Arbeitsmappe.
sheetName	string	path	Der Name des Arbeitsblatts.
startrow	integer	query	Nullbasierter Index der ersten einzublendenden Zeile.
totalRows	integer	query	Anzahl der einzublendenden Zeilen.
height	number	query	Zeilenhöhe (Standardwert: 15,0).
folder	string	query	Der Dokumentordner.
storageName	string	query	Name des Speichers.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser heraus durchzuführen.

Authentifizierung
Alle Anfragen müssen mithilfe eines JWT-Zugriffstokens, das vom Aspose-Cloud-Authentifizierungsdienst erhalten wurde, authentifiziert werden. Schließen Sie das Token in den Header Authorization: Bearer <jwt token> ein.

Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen.

Anfrage

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/unhide?startrow=1&totalRows=1&height=15" \
 -X POST \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer <jwt token>"
# Hinweis: Der POST-Body ist für diesen Endpunkt leer

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ültiges oder fehlendes JWT-Token.
413	Payload Too Large	Die hochgeladene Datei überschreitet die Größeinschränkung.
500	Internal Server Error	Unerwarteter Serverfehler.

Für detaillierte Fehlerbehebung siehe den Leitfaden zur Fehlerbehandlung.

Cloud SDK-Familie

Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Details der unteren Schichten, 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 Aufrufe an Aspose.Cells-Webdienste mit verschiedenen SDKs durchgeführt werden:

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

Developer-Guide: Gruppieren von Zeilen in einem Excel-Arbeitsblatt

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

Diese REST API gruppiert Zeilen in einem Excel-Arbeitsblatt.

Voraussetzungen:

Ein gültiges OAuth 2.0-Zugriffstoken (Bearer JWT) muss im Authorization-Header übermittelt werden.
Die Arbeitsmappe muss bereits im angegebenen folder des gewählten storageName (oder im Standard-Speicher) vorhanden sein, bevor die Anforderung gestellt wird.

PostGroupWorksheetRows API

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

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Der Name der Arbeitsmappendatei.
sheetName	string	path	Der Name des Arbeitsblatts.
firstIndex	integer	query	Nullbasierter Index der ersten zu gruppierenden Zeile.
lastIndex	integer	query	Nullbasierter Index der letzten zu gruppierenden Zeile.
hide	boolean	query	Gibt an, ob die gruppierten Zeilen ausgeblendet werden sollen (`true` oder `false`).
folder	string	query	Pfad zum Ordner, der die Arbeitsmappe enthält.
storageName	string	query	Name des Speichers, in dem sich die Arbeitsmappe befindet.

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 problemlos auf Aspose.Cells-Webservices zuzugreifen. 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/group?firstIndex=1&lastIndex=2&hide=true" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Antwort

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

HTTP-Statuscodes

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

Typische Fehlerantworten:

400 Bad Request – Stellen Sie sicher, dass firstIndex und lastIndex gültige Ganzzahlen sind und dass firstIndex ≤ lastIndex gilt.
401 Unauthorized – Prüfen Sie, ob der Authorization-Header ein aktuelles JWT-Token enthält.
404 Not Found – Stellen Sie sicher, dass die Arbeitsmappe (name) und das Arbeitsblatt (sheetName) im angegebenen folder/storageName vorhanden sind.

Siehe auch: Zeilen in einem Excel-Arbeitsblatt aufheben, Zeilen in einem Excel-Arbeitsblatt ausblenden, Zeilen in einem Excel-Arbeitsblatt einblenden.

Cloud SDK-Familie

Die Verwendung eines SDKs ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt Low-Level-Details, 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-Webservices mit verschiedenen SDKs aufgerufen werden:

Developer-Guide: Gruppierung von Zeilen in einem Excel-Arbeitsblatt aufheben

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

Diese REST API hebt die Gruppierung von Zeilen in einem Excel-Arbeitsblatt auf.

REST API

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/ungroup

Anfrageparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Der Name der Arbeitsmappe.
sheetName	string	path	Der Name des Arbeitsblatts.
firstIndex	integer	query	Der nullbasierte Index der ersten Zeile, deren Gruppierung aufgehoben werden soll.
lastIndex	integer	query	Der nullbasierte Index der letzten Zeile, deren Gruppierung aufgehoben werden soll.
isAll	boolean	query	Falls true, wird die Gruppierung für alle Zeilen im angegebenen Bereich aufgehoben.
folder	string	query	Der Ordner, der die Arbeitsmappe enthält.
storageName	string	query	Der Name des Speichers, in dem sich die Arbeitsmappe befindet.

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-Webdienste einfach aufzurufen. Das folgende Beispiel zeigt, wie Aufrufe an die Cloud-API mit cURL durchgeführt werden.

Anfrage

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/ungroup?firstIndex=1&lastIndex=5&isAll=true" \
 -X POST \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer <jwt token>"

Antwort

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

Cloud SDK-Familie

Die Verwendung eines SDKs ist der beste Weg, die Entwicklungszeit zu verkürzen. Ein SDK übernimmt die Details auf unterster Ebene und ermöglicht es Ihnen, sich auf Ihre Projekt Aufgaben zu konzentrieren. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs anzuzeigen.

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

Developer-Guide:

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

title: “Abrufen einer einzelnen Zeile aus einem Excel-Arbeitsblatt mithilfe der Aspose.Cells Cloud API” description: “Erfahren Sie, wie Sie eine bestimmte Zeile aus einem Excel-Arbeitsblatt abrufen, das im Aspose Cloud Storage gespeichert ist, mithilfe der Aspose.Cells Cloud REST API. Enthält die Anforderungssyntax, Parameter, Antwortschema, ein cURL-Beispiel und SDK-Code (C#, Java, Python).” keywords: “Aspose.Cells Cloud, Zeile abrufen, Excel API, Tabellenkalkulation REST, C# SDK, Java SDK, Python SDK” date: 2026-07-30 api_version: “v3.0”

Abrufen einer einzelnen Zeile aus einem Excel-Arbeitsblatt

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

Ruft eine Zeile aus einem Arbeitsblatt ab, das im Aspose Cloud Storage gespeichert ist. Für diesen Vorgang ist ein gültiger OAuth 2.0-Zugriffstoken mit dem Scope Read erforderlich.

Inhaltsverzeichnis

Voraussetzungen

Aspose Cloud-Konto mit aktiver Subscription.
OAuth 2.0-Zugriffstoken mit dem Scope Read.
Die Ziel-Arbeitsmappe muss bereits im Aspose Cloud Storage vorhanden sein.

HTTP-Anforderung

GET /cells/{name}/worksheets/{sheetName}/rows/{rowIndex}?folder={folder}&storageName={storageName} HTTP/1.1
Host: api.aspose.cloud
Authorization: Bearer {access_token}
Accept: application/json

Base URL: https://api.aspose.cloud/v3.0

Parameter

Pfadparameter

Name	Type	Erforderlich	Beschreibung
`name`	string	✅	Name der Arbeitsmappendatei (z. B. `MeineArbeitsmappe.xlsx`).
`sheetName`	string	✅	Name des Arbeitsblatts (z. B. `Tabelle1`).
`rowIndex`	integer	✅	Nullbasiertes Index der abzurufenden Zeile.

Abfrageparameter (optional)

Name	Type	Erforderlich	Beschreibung
`folder`	string	❌	Pfad zum Ordner im Cloud-Speicher, in dem sich die Arbeitsmappe befindet.
`storageName`	string	❌	Name des Speicherdiensts (falls ein benutzerdefinierter Speicher verwendet wird).

cURL-Beispiel

curl -X GET "https://api.aspose.cloud/v3.0/cells/MeineArbeitsmappe.xlsx/worksheets/Tabelle1/rows/5?folder=Dokumente&storageName=MeinSpeicher" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

Antwort

Erfolgsschema (`200 OK`)

{
  "Code": 200,
  "Status": "OK",
  "Row": {
    "Index": 5,
    "Height": 15.0,
    "Style": { /* Stil-Objekt */ },
    "Cells": [
      { "ColumnIndex": 0, "Value": "A6", "DataType": "String" },
      { "ColumnIndex": 1, "Value": 123, "DataType": "Number" }
      /* ...weitere Zellen... */
    ]
  }
}

Statuscodes

Code	Bedeutung
200	Zeile erfolgreich abgerufen.
401	Nicht autorisiert – fehlender oder ungültiger Zugriffstoken.
404	Arbeitsmappe, Arbeitsblatt oder Zeile nicht gefunden.
500	Interner Serverfehler.

Fehlerbeispiel (`401 Unauthorized`)

{
  "Code": 401,
  "Message": "Zugriffstoken fehlt oder ist ungültig."
}

SDK-Codebeispiele

C#

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

var clientId = "IHR_CLIENT_ID";
var clientSecret = "IHR_CLIENT_SECRET";

var api = new CellsApi(clientId, clientSecret);
var response = api.CellsRows_GetWorksheetRow(
    name: "MeineArbeitsmappe.xlsx",
    sheetName: "Tabelle1",
    rowIndex: 5,
    folder: "Dokumente",
    storageName: null   // optional
);

Console.WriteLine($"Zeile {response.Row.Index} mit {response.Row.Cells.Count} Zellen abgerufen.");

Java

import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.model.RowResponse;

CellsApi api = new CellsApi("IHR_CLIENT_ID", "IHR_CLIENT_SECRET");
RowResponse response = api.cellsRowsGetWorksheetRow(
    "MeineArbeitsmappe.xlsx",
    "Tabelle1",
    5,
    "Dokumente",
    null   // storageName – optional
);

System.out.println("Zeilenindex: " + response.getRow().getIndex());
System.out.println("Zellanzahl: " + response.getRow().getCells().size());

Python

from asposecellscloud import CellsApi, ApiException
from asposecellscloud.models import RowResponse

client_id = "IHR_CLIENT_ID"
client_secret = "IHR_CLIENT_SECRET"

api = CellsApi(client_id, client_secret)

try:
    response = api.cells_rows_get_worksheet_row(
        name="MeineArbeitsmappe.xlsx",
        sheet_name="Tabelle1",
        row_index=5,
        folder="Dokumente",
        storage_name=None
    )
    print(f"Zeile {response.row.index} mit {len(response.row.cells)} Zellen abgerufen.")
except ApiException as e:
    print("Ausnahme beim Aufruf von CellsApi->cells_rows_get_worksheet_row:", e)

Vorgang	Beschreibung
Zeile hinzufügen	`POST /cells/{name}/worksheets/{sheetName}/rows` – Fügt eine neue Zeile in ein Arbeitsblatt ein.
Zeile löschen	`DELETE /cells/{name}/worksheets/{sheetName}/rows/{rowIndex}` – Entfernt eine vorhandene Zeile.
Mehrere Zeilen abrufen	`GET /cells/{name}/worksheets/{sheetName}/rows` – Ruft eine Sammlung von Zeilen ab.
Übersicht über Zeilen	`/cells/rows/` – Allgemeine Dokumentation zu zeilenbezogenen Endpunkten.

Hinweise & Einschränkungen

Rate-Limit: 100 Anfragen pro Minute pro Konto.
Unterstützte Formate: XLS, XLSX, CSV, ODS.
Der Zeilenindex ist nullbasiert; die erste Zeile hat den Index 0.
Stellen Sie sicher, dass die Arbeitsmappe vor dem Aufruf dieses Endpunkts in den angegebenen folder hochgeladen wurde.

Documentation –

Developer-Guide: So fügen Sie Zeilen zu einem Excel-Arbeitsblatt hinzu

So fügen Sie Zeilen zu einem Excel-Arbeitsblatt hinzu

Developer-Guide: Arbeiten mit dem Löschen von Zeilen in einem Excel-Arbeitsblatt

Verfügbare Löschvorgänge

Developer-Guide: Zeilen auf einem Excel-Arbeitsblatt kopieren

Zeilen auf einem Excel-Arbeitsblatt kopieren v3.0

Voraussetzungen

Endpunkt

Pfadparameter

Abfrageparameter

Anforderungsbeispiel (cURL)

Erfolgreiche Antwort

Fehlerbehandlung

SDK-Beispiele

Siehe auch

Developer-Guide: Zeilen in einem Excel-Arbeitsblatt ausblenden

PostHideWorksheetRows API

Sicherheit und Authentifizierung

Anforderungsparameter

Cloud SDK-Familie

Developer-Guide: Zeilen in einem Excel-Arbeitsblatt einblenden

PostUnhideWorksheetRows API

Sicherheit und Authentifizierung

Anfrageparameter

Cloud SDK-Familie

C# Java PHP Ruby Node.js Python Perl Go

Developer-Guide: Gruppieren von Zeilen in einem Excel-Arbeitsblatt

PostGroupWorksheetRows API

Sicherheit und Authentifizierung

Anforderungsparameter

Cloud SDK-Familie

Developer-Guide: Gruppierung von Zeilen in einem Excel-Arbeitsblatt aufheben

REST API

Anfrageparameter

Cloud SDK-Familie

Developer-Guide:

Abrufen einer einzelnen Zeile aus einem Excel-Arbeitsblatt

Inhaltsverzeichnis

Voraussetzungen

HTTP-Anforderung

Parameter

Pfadparameter

Abfrageparameter (optional)

cURL-Beispiel

Antwort

Erfolgsschema (200 OK)

Statuscodes

Fehlerbeispiel (401 Unauthorized)

SDK-Codebeispiele

C#

Java

Python

Verwandte Vorgänge

Hinweise & Einschränkungen

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

Erfolgsschema (`200 OK`)

Fehlerbeispiel (`401 Unauthorized`)