Aspose.Cells Cloud API – Zellbereich zusammenführen

Diese REST API führt einen Zellbereich in einer einzigen Zelle auf einem Excel-Arbeitsblatt zusammen.

Übersicht – Beim Zusammenführen eines Bereichs werden die ausgewählten Zellen zu einer einzigen Zelle verschmolzen, wobei der Wert der oberen linken Zelle beibehalten und die übrigen verworfen werden. Verwenden Sie diesen Vorgang, wenn Sie eine Kopfzeile erstellen möchten, die mehrere Spalten oder Zeilen überspannt, oder wenn Sie das Layout eines Arbeitsblatts vereinfachen möchten.

REST API

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

Anfrageparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Name der Arbeitsmappe.
sheetName	string	path	Name des Arbeitsblatts.
range	object	body	Bereichsobjekt, das die zusammenzuführenden Zellen angibt.
folder	string	query	Ordner, in dem die Arbeitsmappe gespeichert ist.
storageName	string	query	Name des Speichers.

Schema des Anfragetexts

Das Range-Objekt muss die folgenden Felder enthalten (alle anderen sind optional):

Eigenschaft	Typ	Erforderlich	Beschreibung
FirstRow	integer	Ja	Nullbasierter Index der ersten Zeile im Bereich.
FirstColumn	integer	Ja	Nullbasierter Index der ersten Spalte im Bereich.
RowCount	integer	Ja	Anzahl der im Bereich einzuschließenden Zeilen.
ColumnCount	integer	Ja	Anzahl der im Bereich einzuschließenden Spalten.
Name	string	Nein	OPTIONALER Name für den Bereich.
RefersTo	string	Nein	Eine Formel, auf die der Bereich verweist.
Worksheet	string	Nein	Name des Arbeitsblatts (sofern unterschiedlich vom Pfadparameter).
RowHeight	number	Nein	Höhe der Zeilen im Bereich (Pixel).
ColumnWidth	number	Nein	Breite der Spalten im Bereich (Pixel).

Sie können das cURL-Befehlszeilentool verwenden, um einfach auf die Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie ein Aufruf an die Cloud API mit cURL durchgeführt wird.

Anfrage

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/merge" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "FirstRow": 9,
        "FirstColumn": 0,
        "RowCount": 1,
        "ColumnCount": 7
      }'

Antwort

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

Antwortdetails

HTTP-Status	Beschreibung	Beispiel-JSON
200 OK	Der Bereich wurde erfolgreich zusammengeführt.	`{ "Code": 200, "Status": "OK" }`
400 Bad Request	Ungültige Bereichsparameter (z. B. Indices außerhalb des gültigen Bereichs).	`{ "Code": 400, "Message": "Ungültiger Bereich." }`
401 Unauthorized	Fehlendes oder ungültiges JWT-Token.	`{ "Code": 401, "Message": "Authentifizierung fehlgeschlagen." }`
404 Not Found	Arbeitsmappe oder Arbeitsblatt nicht gefunden.	`{ "Code": 404, "Message": "Ressource nicht gefunden." }`
500 Internal Server Error	Unerwarteter Serverfehler.	`{ "Code": 500, "Message": "Interner Serverfehler." }`

Cloud SDK-Familie

Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Details der unteren Schicht, 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: