Benannte Bereiche in einer Excel-Arbeitsmappe abrufen – Aspose.Cells Cloud API

Diese REST-API gibt Informationen zu benannten Bereichen zurück, die in Arbeitsblättern definiert sind.

Hintergrund – Ein benannter Bereich ist eine benutzerdefinierte Kennung, die auf eine bestimmte Zelle oder Zellgruppe in einem Arbeitsblatt verweist. Benannte Bereiche vereinfachen die Formelerstellung, verbessern die Lesbarkeit und ermöglichen programmgesteuerten Zugriff auf häufig verwendete Bereiche einer Arbeitsmappe.

Voraussetzungen – Der Zugriff auf die Aspose.Cells Cloud API erfordert ein gültiges JWT-Access-Token. Holen Sie sich das Token durch Authentifizierung mit Ihrer Aspose-Cloud-Client-ID und Ihrem Clientgeheimnis über den OAuth 2.0-Token-Endpunkt. Binden Sie das Token in den Header Authorization: Bearer <jwt token> jeder Anforderung ein.

GetNamedRanges API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/ranges

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parametername	Typ	Standort	Beschreibung
name	string	Pfad	Der Name der Excel-Datei.
folder	string	Abfragezeichenfolge	Der Ordner, der das Dokument enthält.
storageName	string	Abfragezeichenfolge	Der Speichername, in dem sich das Dokument befindet.

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.

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

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webdienste aufzurufen. Das folgende Beispiel zeigt, wie Sie benannte Bereiche mit cURL abrufen.

Anforderung

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

Antwort

{
  "Ranges": {
    "RangeList": [
      {
        "ColumnCount": 7,
        "ColumnWidth": 8.428571428571429,
        "FirstColumn": 1,
        "FirstRow": 9,
        "Name": "data",
        "RefersTo": "=Sheet1!$B$10:$H$10",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Antwortmodell

Feld	Typ	Beschreibung
`ColumnCount`	integer	Anzahl der Spalten im Bereich.
`ColumnWidth`	number	Breite jeder Spalte (in Punkten).
`FirstColumn`	integer	Nullbasierter Index der ersten Spalte im Bereich.
`FirstRow`	integer	Nullbasierter Index der ersten Zeile im Bereich.
`Name`	string	Der benutzerdefinierte Name des Bereichs.
`RefersTo`	string	Eine Formel, die die Zellreferenz definiert (z. B. `=Sheet1!$B$10:$H$10`).
`RowCount`	integer	Anzahl der Zeilen im Bereich.
`RowHeight`	number	Höhe jeder Zeile (in Punkten).
`Worksheet`	string	Name des Arbeitsblatts, das den Bereich enthält.

Cloud SDK-Familie

Die Verwendung eines SDKs ist der schnellste Weg, diese Funktionalität zu integrieren. SDKs übernehmen die Low-Level-Details, 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 Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden:

Zellendaten basierend auf benanntem Bereich abrufen