Wertebereich in einem Excel-Arbeitsblatt festlegen – Aspose.Cells Cloud API
Nutzen Sie diese REST API, um einen Wert im angegebenen Bereich festzulegen. Bei geeigneter Gegebenheit wird der Wert in einen anderen Datentyp konvertiert und das Zahlenformat der Zelle zurückgesetzt.
Voraussetzungen
- Ein gültiger Aspose Cloud-Account.
- Ein JWT-Token mit dem Bereich
Cells.ReadWrite. - Die Arbeitsmappe muss bereits in den Ziel-Speicherort hochgeladen worden sein.
PostWorksheetCellsRangeValue API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value
Die Anfrageparameter sind:
| Parametername | Typ | Ort | Beschreibung |
|---|---|---|---|
| name | string | path | Name der Arbeitsmappe |
| sheetName | string | path | Name des Arbeitsblatts |
| value | string | query | Eingabewert |
| range | object | body | Bereichsobjekt im Arbeitsblatt |
| isConverted | boolean | query | Gibt an, ob der Eingabewert konvertiert werden soll |
| setStyle | boolean | query | Gibt an, ob das Format auf die Zielzellen angewendet werden soll |
| folder | string | query | Ordner der Arbeitsmappe |
| storageName | string | query | Name des Speichers |
Beispiel für das range-Objekt, das im Anfragetext gesendet werden kann:
{
"range": {
"FirstRow": 0,
"FirstColumn": 0,
"RowCount": 1,
"ColumnCount": 1
}
}
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-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie die Cloud-API mit cURL aufgerufen wird. Geben Sie ein gültiges JWT-Token im Header Authorization an.
Antworthschema
| Feld | Typ | Beschreibung |
|---|---|---|
| Code | integer | HTTP-Statuscode des Vorgangs. |
| Status | string | Kurze Beschreibung des Ergebnisses (z. B. „OK“). |
| Message | string | Detaillierte Fehlermeldung bei fehlgeschlagenen Anfragen (optional). |
| Result | object | Zusätzliche Daten für erfolgreiche Aufrufe (optional). |
Mögliche HTTP-Statuscodes
- 200 OK – Der Bereichswert wurde erfolgreich festgelegt.
- 400 Bad Request – Ungültige Parameter oder fehlerhafter Anfragetext.
- 401 Unauthorized – Fehlendes oder ungültiges JWT-Token.
- 403 Forbidden – Unzureichende Berechtigungen für den angeforderten Vorgang.
- 404 Not Found – Die angegebene Arbeitsmappe, das Arbeitsblatt oder der Bereich existiert nicht.
- 500 Internal Server Error – Unerwarteter Serverfehler.
Beispiel für eine Fehlerantwort bei „400 Bad Request“:
{
"Code": 400,
"Status": "Bad Request",
"Message": "Das Objekt 'range' fehlen erforderliche Felder."
}
Cloud SDK-Familie
Die Verwendung eines SDKs ist die beste Möglichkeit, die Entwicklungszeit zu verkürzen. Ein SDK übernimmt die Low-Level-Details 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 zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webdienste mit verschiedenen SDKs durchgeführt werden: