Bir Excel çalışma sayfasındaki tüm OLE nesnelerini silme

OleObjects – Clear işlemi, belirtilen bir çalışma sayfasından tüm OLE (Nesne Bağlama ve Gömme) nesnelerini kaldırır, hücre verilerini ise olduğu gibi bırakır. Bu işlem, eski hesap tablolarını temizlemek veya bir çalışma kitabını yeniden dağıtım için hazırlamak için yararlıdır.

Ön Gereksinimler

Not: İşlem idempotandır – OLE nesnesi bulunmayan bir çalışma sayfasında bu işlemi yürütmek, başarılı bir 200 OK yanıtı döndürür.

HTTP İsteği

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

Yol parametreleri

Ad Tür Gerekli Açıklama
name string ✔️ Çalışma kitap dosyasının adı.
sheetName string ✔️ Çalışma sayfasının adı.

Sorgu parametreleri

Ad Tür Gerekli Açıklama
folder string isteğe bağlı Çalışma kitabının bulunduğu klasör.
storageName string isteğe bağlı Çalışma kitabının bulunduğu depo adı.

İstek başlıkları

Başlık Değer
Authorization Bearer <jwt token>
Accept application/json
Content-Type application/json

İstek Örneği (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"

<jwt token> ifadesini geçerli bir erişim belirteci ile değiştirin ve gerekirse folder/storageName değerlerini uygun şekilde ayarlayın.

Başarılı Yanıt

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

HTTP Durum Kodları

Kod Anlam Açıklama
200 OK Filtre başarıyla uygulandı; yanıt işlem ayrıntılarını içerir.
400 Bad Request (Hatalı İstek) Eksik veya geçersiz parametreler (örn., desteklenmeyen dosya türü).
401 Unauthorized (Yetkisiz) Geçersiz veya eksik JWT belirteci.
413 Payload Too Large (Çok Büyük Yük) Yüklenecek dosya boyut sınırını aşıyor.
500 Internal Server Error (İç Sunucu Hatası) Beklenmeyen sunucu hatası.

SDK Örnekleri

Aşağıdaki kod parçacıkları, resmi Aspose.Cells Cloud SDK’ları ile DeleteWorksheetOleObjects işlemini nasıl çağıracağınızı gösterir. Yer tutucu değerleri (<YOUR_TOKEN>, <FILE_NAME> vb.) kendi verilerinizle değiştirin.

Dil Örnek
C#
C# örneğini göstercsharp\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 örneğini gösterjava\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 örneğini gösterpython\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 örneğini gösterjavascript\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 örneğini göstergo\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

Tüm desteklenen diller için tam kaynak dosyaları Aspose.Cells Cloud GitHub deposunda mevcuttur.

Hatalar ve Yönetimi

Geçici 500 hataları için üssel geri plan stratejisiyle yeniden deneme mantığı uygulayın.

SSS

S1: folder ve storageName parametrelerini belirtmem gerekiyor mu?
C: Hayır. Belirtilmezlerse Aspose Cloud, varsayılan depo ve kök klasörü kullanır.

S2: Yalnızca belirli bir hücreden OLE nesnelerini silebilir miyim?
C: Bu uç nokta, çalışma sayfasındaki tüm OLE nesnelerini siler. Tek bir nesneyi kaldırmak için Belirli bir OLE nesnesini sil işlemini kullanın.

S3: Çalışma kitabı düzenleme için kilitliyse ne olur?
C: API, dosyanın kilitli olduğunu belirten bir 400 Bad Request (Hatalı İstek) hatası döndürür. Uç noktayı çağırmadan önce dosyanın başka bir yerde açılmadığından emin olun.

S4: Çalışma kitabı için boyut sınırı var mı?
C: Hizmet, genel Aspose Cloud dosya boyutu sınırlarını (şu anda dosya başına en fazla 2 GB) uygular. Daha büyük dosyalar bölünebilir veya parça parça işlenebilir.

En İyi Uygulamalar

İlgili İşlemler

Sayfanın altında yer alan gezinti bağlantılarını kullanarak ilgili API işlemlerine geçiş yapın.