Alle OLE-Objekte in einem Excel-Arbeitsblatt löschen

OleObjects – Clear entfernt alle OLE-Objekte (Object Linking and Embedding) aus einem angegebenen Arbeitsblatt, während die Zellendaten unverändert bleiben. Diese Operation ist nützlich, um veraltete Tabellenkalkulationen zu bereinigen oder eine Arbeitsmappe für die erneute Verteilung vorzubereiten.

Voraussetzungen

Hinweis: Die Operation ist idempotent – das Aufrufen, wenn keine OLE-Objekte vorhanden sind, gibt einen erfolgreichen 200 OK-Status zurück.

HTTP-Anforderung

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects

Pfadparameter

Name Typ Erforderlich Beschreibung
name string ✔️ Der Name der Arbeitsmappe-Datei.
sheetName string ✔️ Der Name des Arbeitsblatts.

Abfrageparameter

Name Typ Erforderlich Beschreibung
folder string optional Ordner, der die Arbeitsmappe enthält.
storageName string optional Name des Speichers, in dem sich die Arbeitsmappe befindet.

Header

Header Wert
Authorization Bearer <jwt token>
Accept application/json
Content-Type application/json

Beispielanforderung (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects?folder=Samples&storageName=MyStorage" \
     -X DELETE \
     -H "Authorization: Bearer <jwt token>" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json"

Ersetzen Sie <jwt token> durch einen gültigen Zugriffstoken und passen Sie folder/storageName entsprechend an.

Erfolgreiche Antwort

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

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ültiger oder fehlender JWT-Token.
413 Payload Too Large Die hochgeladene Datei überschreitet die Größenbeschränkung.
500 Internal Server Error Unerwarteter Serverfehler.

SDK-Beispiele

Die folgenden Code-Snippets zeigen, wie DeleteWorksheetOleObjects mit den offiziellen Aspose.Cells Cloud SDKs aufgerufen wird. Ersetzen Sie Platzhalterwerte (<YOUR_TOKEN>, <FILE_NAME> usw.) durch Ihre eigenen Daten.

Sprache Beispiel
C#
C#-Beispiel anzeigencsharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar config = new Configuration { AccessToken = "<YOUR_TOKEN>", BasePath = "https://api.aspose.cloud" };\nvar api = new OleObjectsApi(config);\napi.DeleteWorksheetOleObjects(name: "Sample.xlsx", sheetName: "Sheet1", folder: "Samples", storageName: null);\n
Java
Java-Beispiel anzeigenjava\nimport com.aspose.cells.cloud.api.OleObjectsApi;\nimport com.aspose.cells.cloud.client.ApiClient;\nimport com.aspose.cells.cloud.client.Configuration;\n\nConfiguration config = new Configuration();\nconfig.setAccessToken("<YOUR_TOKEN>");\nconfig.setBasePath("https://api.aspose.cloud");\nOleObjectsApi api = new OleObjectsApi(new ApiClient(config));\napi.deleteWorksheetOleObjects("Sample.xlsx", "Sheet1", "Samples", null);\n
Python
Python-Beispiel anzeigenpython\nfrom asposecellscloud import ApiClient, Configuration, OleObjectsApi\n\nconfig = Configuration()\nconfig.access_token = '<YOUR_TOKEN>'\nconfig.host = 'https://api.aspose.cloud'\nclient = ApiClient(configuration=config)\napi = OleObjectsApi(client)\napi.delete_worksheet_ole_objects(name='Sample.xlsx', sheet_name='Sheet1', folder='Samples')\n
Node.js
Node.js-Beispiel anzeigenjavascript\nconst { OleObjectsApi, Configuration } = require('asposecellscloud');\n\nlet config = new Configuration({ accessToken: '<YOUR_TOKEN>', basePath: 'https://api.aspose.cloud' });\nlet api = new OleObjectsApi(config);\napi.deleteWorksheetOleObjects('Sample.xlsx', 'Sheet1', { folder: 'Samples' })\n .then(() => console.log('All OLE objects deleted'))\n .catch(err => console.error(err));\n
Go
Go-Beispiel anzeigengo\npackage main\nimport (\n "context"\n "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"\n)\n\nfunc main() {\n cfg := asposecellscloud.NewConfiguration()\n cfg.AccessToken = "<YOUR_TOKEN>"\n cfg.Host = "https://api.aspose.cloud"\n api := asposecellscloud.NewOleObjectsApi(cfg)\n _, err := api.DeleteWorksheetOleObjects(context.Background(), "Sample.xlsx", "Sheet1", map[string]interface{}{ "folder": "Samples" })\n if err != nil { panic(err) }\n println("All OLE objects deleted")\n}\n

Vollständige Quellcodedateien für alle unterstützten Sprachen finden Sie im Aspose.Cells Cloud GitHub-Repository.

Fehler & Behandlung

Implementieren Sie eine Wiederholungslogik mit exponentiellem Backoff für vorübergehende 500-Fehler.

FAQ

Q1: Muss ich die Parameter folder und storageName angeben?
A: Nein. Falls diese weggelassen werden, nimmt Aspose Cloud den Standard-Speicher und den Root-Ordner an.

Q2: Kann ich OLE-Objekte nur aus einer bestimmten Zelle entfernen?
A: Dieser Endpunkt löscht alle OLE-Objekte im Arbeitsblatt. Um ein einzelnes Objekt zu entfernen, verwenden Sie den Vorgang Ein bestimmtes OLE-Objekt löschen.

Q3: Was passiert, wenn die Arbeitsmappe zum Bearbeiten gesperrt ist?
A: Die API gibt 400 Bad Request mit einer Meldung zurück, dass die Datei gesperrt ist. Stellen Sie sicher, dass die Datei außerhalb dieses Vorgangs nicht geöffnet ist.

Q4: Gibt es eine Größenbeschränkung für die Arbeitsmappe?
A: Der Dienst folgt den allgemeinen Größenbeschränkungen von Aspose Cloud (aktuell bis zu 2 GB pro Datei). Größere Dateien müssen möglicherweise aufgeteilt oder in Teilen verarbeitet werden.

Best Practices

Verwandte Vorgänge

Verwenden Sie die Navigationslinks am unteren Ende der Seite, um zwischen verwandten API-Vorgängen zu wechseln.