Documentation –

Developer-Guide: Zeilenbeschreibung aus einem Excel-Arbeitsblatt abrufen

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

Voraussetzungen:

Holen Sie sich ein gültiges JWT-Zugriffstoken und fügen Sie es in den Header Authorization: Bearer <jwt token> ein.
Stellen Sie sicher, dass die Arbeitsmappe im Aspose Cloud-Speicher gespeichert ist, oder geben Sie den Pfad des Ordners an, in dem sie sich befindet.
Verwenden Sie API-Version v3.0, wie in der Endpunkt-URL gezeigt.

Diese REST-API ruft Zeilendaten anhand ihres Index in einem Excel-Arbeitsblatt ab.

GetWorksheetRow API

GET 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	Ort	Beschreibung
name	string	path	Der Name der Arbeitsmappen-Datei.
sheetName	string	path	Der Name des Arbeitsblatts innerhalb der Arbeitsmappe.
rowIndex	integer	path	Nullbasierter Index der abzurufenden Zeile.
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 es Ihnen, REST-Interaktionen direkt aus einem Webbrowser heraus durchzuführen.

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen. Fügen Sie den Header Authorization: Bearer <jwt token> hinzu, um die Anfrage zu authentifizieren.

Anforderung

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

Antwort

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

Antwort-Schema

Eigenschaft	Typ	Beschreibung
`GroupLevel`	integer	Gliederungsebene der Zeile (wird für Gruppierung verwendet).
`Height`	number	Höhe der Zeile in Punkten.
`Index`	integer	Nullbasierter Index der zurückgegebenen Zeile.
`IsBlank`	boolean	Gibt an, ob die Zeile Daten enthält.
`IsHeightMatched`	boolean	`true`, wenn die Zeilenhöhe mit der Standardzeilenhöhe übereinstimmt.
`IsHidden`	boolean	`true`, wenn die Zeile ausgeblendet ist.
`Style`	object	Objekt mit Stilinformationen für die Zeile.
`link`	object	Hyperlink-Verweis auf die Zeilenressource.
`Code`	integer	HTTP-Statuscode der Antwort.
`Status`	string	Textuelle Beschreibung des Status (z. B. „OK“).

Hinweise / Fehlerbehandlung: Die API kann die folgenden HTTP-Statuscodes zurückgeben:

200 – Erfolg; die Zeilendaten werden zurückgegeben.
401 – Nicht autorisiert; das JWT-Token fehlt oder ist ungültig.
404 – Nicht gefunden; die angegebene Arbeitsmappe, das Arbeitsblatt oder die Zeile existiert nicht.
500 – Interner Serverfehler; es ist eine unerwartete Bedingung aufgetreten.

Code	Beschreibung	Behebung
200	Erfolg – Zeilendaten wurden zurückgegeben.	–
401	Nicht autorisiert – fehlendes oder ungültiges JWT-Token.	Geben Sie ein gültiges JWT-Token an.
404	Nicht gefunden – Arbeitsmappe, Arbeitsblatt oder Zeile fehlt.	Überprüfen Sie Namen und Zeilenindex.
500	Interner Serverfehler – unerwartete Bedingung.	Wenden Sie sich an den Aspose-Support.

Eine vollständige Liste der Fehlercodes finden Sie in der Aspose.Cells Cloud Dokumentation zu Fehlercodes.

Cloud SDK-Familie

Die Verwendung eines SDKs ist die schnellste Möglichkeit zur Entwicklung. Ein SDK abstrahiert die Low-Level-Details, sodass Sie sich auf Ihre Projekt Aufgaben konzentrieren können. Bitte überprüfen 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:

Developer-Guide: Zeileninformationen aus einer Excel-Arbeitsmappe abrufen

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

Diese REST-API ruft Zeileninformationen aus einer Excel-Arbeitsmappe ab.

Voraussetzungen
Um diesen Endpunkt aufzurufen, müssen Sie ein gültiges JWT-Token im Header Authorization bereitstellen. Das Token muss mithilfe des Authentifizierungsflusses von Aspose.Cloud erworben werden und die erforderlichen Berechtigungen (Scopes) für Cells-Vorgänge enthalten. Die API folgt dem Versionschema v3.0 und unterliegt den Standard-Rate-Limit-Richtlinien.

GetWorksheetRows API

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

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 Arbeitsmappe.
sheetName	string	path	Der Name des Arbeitsblatts.
folder	string	query	Der Ordner der Arbeitsmappe.
storageName	string	query	Der Speichername.

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

Sie können das Kommandozeilentool cURL verwenden, um bequem 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" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Antwort

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Antwortcodes

Code	Bedeutung	Beschreibung
200	OK	Die Anforderung war erfolgreich; die Zeileninformationen wurden zurückgegeben.
400	Bad Request	Die Anforderung ist fehlerhaft (z. B. fehlende erforderliche Parameter).
401	Unauthorized	Ungültiges oder fehlendes JWT-Token.
404	Not Found	Die angegebene Arbeitsmappe oder das angegebene Arbeitsblatt existiert nicht.
500	Internal Server Error	Auf dem Server ist ein unerwarteter Fehler aufgetreten.

Cloud SDK-Familie

Die Verwendung eines SDK ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt Details auf niedriger Ebene, sodass Sie sich auf Ihre Projektanforderungen 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-Webservices mit verschiedenen SDKs durchgeführt werden:

Anforderung

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

Antwort

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Cloud SDK-Familie

Die Verwendung eines SDK ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt Details auf niedriger Ebene, sodass Sie sich auf Ihre Projektanforderungen konzentrieren können. Nachfolgend finden Sie sprachspezifische Codebeispiele zum Abrufen von Arbeitsblattzeilen.