Supprimer tous les objets OLE dans une feuille de calcul Excel

OleObjects – Clear supprime tous les objets OLE (Object Linking and Embedding, ou liaison et intégration d’objets) d’une feuille de calcul spécifiée, tout en laissant les données des cellules intactes. Cette opération est utile pour nettoyer des classeurs hérités ou préparer un classeur à une redistribution.

Conditions préalables

Remarque : L’opération est idempotente – l’appeler alors qu’aucun objet OLE n’existe renvoie un succès 200 OK.

Requête HTTP

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

Paramètres de chemin

Nom Type Obligatoire Description
name string ✔️ Nom du fichier du classeur.
sheetName string ✔️ Nom de la feuille de calcul.

Paramètres de requête

Nom Type Obligatoire Description
folder string optionnel Dossier contenant le classeur.
storageName string optionnel Nom du stockage où se trouve le classeur.

En-têtes

En-tête Valeur
Authorization Bearer <jeton jwt>
Accept application/json
Content-Type application/json

Exemple de requête (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 <jeton jwt>" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json"

Remplacez <jeton jwt> par un jeton d’accès valide et ajustez folder/storageName selon vos besoins.

Réponse réussie

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

Codes de statut HTTP

Code Signification Description
200 OK Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400 Mauvaise requête Paramètres manquants ou invalides (par ex. type de fichier non pris en charge).
401 Non autorisé Jeton JWT invalide ou manquant.
413 Charge utile trop grande Le fichier téléchargé dépasse la limite de taille.
500 Erreur interne du serveur Erreur serveur inattendue.

Exemples de SDK

Les extraits de code suivants montrent comment appeler DeleteWorksheetOleObjects à l’aide des SDK officiels d’Aspose.Cells Cloud. Remplacez les valeurs génériques (<VOTRE_JETON>, <NOM_FICHIER>, etc.) par vos propres données.

Langage Exemple
C#
Afficher l’exemple C#csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar config = new Configuration { AccessToken = "<VOTRE_JETON>", BasePath = "https://api.aspose.cloud" };\nvar api = new OleObjectsApi(config);\napi.DeleteWorksheetOleObjects(name: "Sample.xlsx", sheetName: "Sheet1", folder: "Samples", storageName: null);\n
Java
Afficher l’exemple Javajava\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("<VOTRE_JETON>");\nconfig.setBasePath("https://api.aspose.cloud");\nOleObjectsApi api = new OleObjectsApi(new ApiClient(config));\napi.deleteWorksheetOleObjects("Sample.xlsx", "Sheet1", "Samples", null);\n
Python
Afficher l’exemple Pythonpython\nfrom asposecellscloud import ApiClient, Configuration, OleObjectsApi\n\nconfig = Configuration()\nconfig.access_token = '<VOTRE_JETON>'\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
Afficher l’exemple Node.jsjavascript\nconst { OleObjectsApi, Configuration } = require('asposecellscloud');\n\nlet config = new Configuration({ accessToken: '<VOTRE_JETON>', basePath: 'https://api.aspose.cloud' });\nlet api = new OleObjectsApi(config);\napi.deleteWorksheetOleObjects('Sample.xlsx', 'Sheet1', { folder: 'Samples' })\n .then(() => console.log('Tous les objets OLE ont été supprimés'))\n .catch(err => console.error(err));\n
Go
Afficher l’exemple Gogo\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 = "<VOTRE_JETON>"\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("Tous les objets OLE ont été supprimés")\n}\n

Les fichiers sources complets pour tous les langages pris en charge sont disponibles sur le dépôt GitHub d’Aspose.Cells Cloud.

Erreurs et gestion

Implémentez une logique de reprise avec backoff exponentiel pour les erreurs transitoires 500.

FAQ

Q1 : Dois-je spécifier les paramètres folder et storageName ?
R : Non. Si omis, Aspose Cloud utilise le stockage par défaut et le dossier racine.

Q2 : Puis-je supprimer des objets OLE à partir d’une cellule spécifique uniquement ?
R : Cet endpoint supprime tous les objets OLE présents dans la feuille de calcul. Pour supprimer un seul objet, utilisez l’opération Supprimer un objet OLE spécifique.

Q3 : Que se passe-t-il si le classeur est verrouillé en mode édition ?
R : L’API renverra 400 Mauvaise requête avec un message indiquant que le fichier est verrouillé. Assurez-vous que le fichier n’est pas ouvert ailleurs avant d’appeler l’endpoint.

Q4 : Existe-t-il une limite de taille pour le classeur ?
R : Le service suit les limites générales de taille de fichier d’Aspose Cloud (actuellement jusqu’à 2 Go par fichier). Les fichiers plus volumineux devront être divisés ou traités par parties.

Bonnes pratiques

Opérations connexes

Utilisez les liens de navigation en bas de page pour passer d’une opération API à l’autre.