OLE-Objekt in Bild konvertieren

Rufen Sie ein eingebettetes OLE-Objekt aus einem Arbeitsblatt ab und geben Sie es im gewünschten Bildformat zurück.

Voraussetzungen

Bevor Sie diesen Endpunkt aufrufen, stellen Sie sicher, dass Folgendes vorliegt:

  1. Aspose.Cells Cloud-Konto – Registrieren Sie sich im Aspose Cloud-Portal.
  2. Arbeitsmappe im Cloud-Speicher hochgeladen – Verwenden Sie die Upload File-API oder die Aspose Cloud-Oberfläche.
  3. JWT-Zugriffstoken – Holen Sie sich ein Token gemäß der Authentifizierungsanleitung.

Sicherheit & Authentifizierung

Alle Aspose.Cells Cloud-APIs erfordern eine JWT-Token-basierte Authentifizierung. Geben Sie das Token im Authorization-Header an:

Authorization: Bearer <jwt-token>

Es werden ausschließlich HTTPS-Endpunkte unterstützt; verwenden Sie niemals http://.

Anforderung

HTTP-Methode

GET

Endpunkt

https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}?format={format}

Pfadparameter

Name Typ Erforderlich Beschreibung
name string ✅ Name der Arbeitsmappendatei (z. B. Book1.xlsx).
sheetName string ✅ Arbeitsblatt, das das OLE-Objekt enthält.
objectNumber integer ✅ Nullbasierter Index des OLE-Objekts.

Abfrageparameter

Name Typ Erforderlich Beschreibung
format string ❌ Gewünschtes Bildformat (png, jpeg, tiff, gif, emf, bmp). Bei Weglassung ist der Standardwert png.
folder string ❌ Pfad zum Ordner, in dem sich die Arbeitsmappe befindet.
storageName string ❌ Name des Speicherdiensts (z. B. MyCloud).

Beispielanforderung (cURL)

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

Ersetzen Sie <jwt-token> durch ein gültiges JWT-Token.

Antwort

Status Content‑Type Beschreibung
200 image/png (oder gewünschtes Format) Binäre Bilddaten, die das OLE-Objekt darstellen.
400 application/json Ungültige Anforderungsparameter.
401 application/json Authentifizierung fehlgeschlagen (fehlendes/ungültiges JWT).
404 application/json Angegebene Arbeitsmappe, Arbeitsblatt oder OLE-Objekt nicht gefunden.
500 application/json Serverseitiger Fehler.

Verarbeiten der binären Antwort

Die API gibt rohe Bilddaten zurück. Sie können:

Fehlerantworten

HTTP-Status Code Nachricht
400 InvalidParameter Mindestens ein Anforderungsparameter ist ungültig.
401 AuthenticationFailed Fehlendes oder ungültiges JWT-Token.
404 PropertyNotFound Die angeforderte Arbeitsmappe, das Arbeitsblatt oder das OLE-Objekt ist nicht vorhanden.
500 InternalError Ein unerwarteter Fehler ist auf dem Server aufgetreten.

SDK-Beispiele

Die folgenden Codeausschnitte zeigen, wie der Vorgang mit den offiziellen SDKs aufgerufen wird. Ersetzen Sie YOUR_JWT_TOKEN und andere Platzhalter durch Ihre tatsächlichen Werte.

Sprache Beispiel
C#
Code anzeigencsharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model.Requests;\n\nvar config = new Configuration { AccessToken = "YOUR_JWT_TOKEN" };\nvar api = new OleObjectsApi(config);\nvar request = new GetWorksheetOleObjectRequest(\n name: "Embedded_OleObject_Sample_Book1.xlsx",\n sheetName: "Sheet1",\n objectNumber: 0,\n format: "png"\n);\nvar stream = api.GetWorksheetOleObject(request);\nusing var file = File.Create("oleobject.png");\nstream.CopyTo(file);\n
Java
Code anzeigenjava\nimport com.aspose.cells.cloud.ApiException;\nimport com.aspose.cells.cloud.api.OleObjectsApi;\nimport com.aspose.cells.cloud.model.*;\nimport com.aspose.cells.cloud.model.requests.*;\nimport java.io.FileOutputStream;\nimport java.io.InputStream;\n\nOleObjectsApi api = new OleObjectsApi();\napi.getApiClient().setAccessToken("YOUR_JWT_TOKEN");\nGetWorksheetOleObjectRequest req = new GetWorksheetOleObjectRequest(\n "Embedded_OleObject_Sample_Book1.xlsx",\n "Sheet1",\n 0,\n "png",\n null,\n null\n);\nInputStream stream = api.getWorksheetOleObject(req);\ntry (FileOutputStream out = new FileOutputStream("oleobject.png")) {\n stream.transferTo(out);\n}\n
Python
Code anzeigenpython\nfrom asposecellscloud import CellsApi, GetWorksheetOleObjectRequest\n\napi = CellsApi()\napi.api_client.configuration.access_token = "YOUR_JWT_TOKEN"\nrequest = GetWorksheetOleObjectRequest(\n name="Embedded_OleObject_Sample_Book1.xlsx",\n sheet_name="Sheet1",\n object_number=0,\n format="png"\n)\nstream = api.get_worksheet_ole_object(request)\nwith open('oleobject.png', 'wb') as f:\n f.write(stream.read())\n
Node.js
Code anzeigenjavascript\nconst { CellsApi, GetWorksheetOleObjectRequest } = require('asposecellscloud');\n\nconst api = new CellsApi();\napi.apiClient.configuration.accessToken = 'YOUR_JWT_TOKEN';\n\nconst request = new GetWorksheetOleObjectRequest({\n name: 'Embedded_OleObject_Sample_Book1.xlsx',\n sheetName: 'Sheet1',\n objectNumber: 0,\n format: 'png'\n});\napi.getWorksheetOleObject(request).then(stream => {\n const fs = require('fs');\n const writeStream = fs.createWriteStream('oleobject.png');\n stream.pipe(writeStream);\n});\n
Go
Code anzeigengo\npackage main\nimport (\n "io"\n "os"\n cells "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"\n)\nfunc main() {\n cfg := cells.NewConfiguration()\n cfg.AccessToken = "YOUR_JWT_TOKEN"\n api := cells.NewOleObjectsApi(cfg)\n req := cells.GetWorksheetOleObjectRequest{\n Name: "Embedded_OleObject_Sample_Book1.xlsx",\n SheetName: "Sheet1",\n ObjectNumber: 0,\n Format: "png",\n }\n stream, _, err := api.GetWorksheetOleObject(req)\n if err != nil { panic(err) }\n out, _ := os.Create("oleobject.png")\n defer out.Close()\n io.Copy(out, stream)\n}\n
PHP
Code anzeigenphp\n<?php\nrequire_once 'vendor/autoload.php';\nuse Aspose\\Cells\\Cloud\\Api\\OleObjectsApi;\nuse Aspose\\Cells\\Cloud\\Model\\Requests\\GetWorksheetOleObjectRequest;\n\n$config = new \\Aspose\\Cells\\Cloud\\Configuration();\n$config->setAccessToken('YOUR_JWT_TOKEN');\n$apiInstance = new OleObjectsApi($config);\n$request = new GetWorksheetOleObjectRequest(\n 'Embedded_OleObject_Sample_Book1.xlsx',\n 'Sheet1',\n 0,\n 'png'\n);\n$stream = $apiInstance->getWorksheetOleObject($request);\nfile_put_contents('oleobject.png', $stream);\n?>\n
Ruby
Code anzeigenruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::OleObjectsApi.new\napi.api_client.config.access_token = 'YOUR_JWT_TOKEN'\nrequest = AsposeCellsCloud::GetWorksheetOleObjectRequest.new(\n name: 'Embedded_OleObject_Sample_Book1.xlsx',\n sheet_name: 'Sheet1',\n object_number: 0,\n format: 'png'\n)\nstream = api.get_worksheet_ole_object(request)\nFile.open('oleobject.png', 'wb') { |f| f.write(stream) }\n\n
Perl
Code anzeigenperl\nuse AsposeCellsCloud::Api::OleObjectsApi;\nuse AsposeCellsCloud::Object::GetWorksheetOleObjectRequest;\n\nmy $api = AsposeCellsCloud::Api::OleObjectsApi->new();\n$api->{api_client}->{config}->{access_token} = 'YOUR_JWT_TOKEN';\nmy $req = AsposeCellsCloud::Object::GetWorksheetOleObjectRequest->new(\n name => 'Embedded_OleObject_Sample_Book1.xlsx',\n sheet_name => 'Sheet1',\n object_number => 0,\n format => 'png'\n);\nmy $stream = $api->get_worksheet_ole_object(request => $req);\nopen my $fh, '>', 'oleobject.png' or die $!;\nbinmode $fh;\nprint $fh $stream;\nclose $fh;\n

(Die vollständige Liste der SDKs finden Sie im GitHub-Repository.)

Verwandte Vorgänge

Weitere Details finden Sie auf den entsprechenden API-Referenzseiten.

Weitere Ressourcen