Bir Excel Çalışma Sayfasında bir OLE Nesnesini Güncelleme – Aspose.Cells Cloud API Kılavuzu

Bu REST API, bir Excel çalışma sayfasındaki bir OLE nesnesini günceller.

Güvenlik ve Kimlik Doğrulama

Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.

PostUpdateWorksheetOleObject API

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

İstek parametreleri:

Parametre Adı Tür Parametre Konumu Açıklama
name string path Çalışma kitabının adı.
sheetName string path Çalışma sayfasının adı.
oleObjectIndex integer path Çalışma sayfası içindeki OLE nesnesinin indeksi.
ole object body Güncellenecek OLE nesnesinin JSON gösterimi.
folder string query Çalışma kitabını içeren klasör.
storageName string query Depolama hizmetinin adı.

İstek Gövdesi Alanları

Alan Tür Gerekli Açıklama
ImageSourceFullName string isteğe bağlı OLE nesnesi için kullanılan resim dosyasının yolu.
IsAutoSize boolean isteğe bağlı OLE nesnesinin otomatik boyutlandırılıp olmayacağını belirtir.
SourceFullName string gerekli OLE nesnesinin kaynağı (örneğin bir resim veya grafik).
UpperLeftRow integer gerekli Üst sol köşenin satır indeksi (sıfır tabanlı).
UpperLeftColumn integer gerekli Üst sol köşenin sütun indeksi (sıfır tabanlı).
Left integer isteğe bağlı Üst sol köşeden yatay ofset, nokta cinsinden.
Top integer isteğe bağlı Üst sol köşeden dikey ofset, nokta cinsinden.
Width integer gerekli OLE nesnesinin genişliği, nokta cinsinden.
Height integer gerekli OLE nesnesinin yüksekliği, nokta cinsinden.

OpenAPI Specification, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenizi sağlar.

Aspose.Cells web hizmetlerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile Bulut API’sini nasıl çağıracağınızı göstermektedir.

Hata Yanıtları

HTTP Durumu Kod Mesaj
400 4000 Geçersiz istek – eksik veya geçersiz parametreler.
401 4010 Yetkisiz erişim – geçersiz veya eksik JWT belirteci.
404 4040 Bulunamadı – çalışma kitabında, çalışma sayfasında veya OLE nesnesinde hata var.
500 5000 İç sunucu hatası – sunucu tarafında beklenmedik bir arıza.

API ayrıca yanıt gövdesinde HTTP durumuna karşılık gelen özel bir Code alanını da döndürür (örneğin, 200 → 2000, 400 → 4000 vb.).

Bu API Ne Zaman Kullanılmalı?

Mevcut bir OLE nesnesini (gömülü resim, grafik veya belge gibi) tüm çalışma sayfasını yeniden yüklemeksizin değiştirmeniz gerektiğinde bu uç noktayı kullanın. Tipik senaryolar, resim kaynağını güncellemek, nesneyi yeniden boyutlandırmak veya çalışma kitabı oluşturulduktan sonra konumunu değiştirmek içerir. İlgili işlemler için bkz. OLE Nesnesi Ekle ve OLE Nesnesi Sil.

Bulut SDK Ailesi

SDK kullanmak, geliştirme yapmanın en hızlı yoludur. SDK, alt seviye ayrıntıları soyutlar, böylece projenize odaklanabilirsiniz. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna bakın.

Aşağıda, Aspose.Cells Cloud SDK kullanarak bir OLE nesnesini güncelleyen kısa bir C# örneği verilmiştir:

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var config = new Configuration
{
    AppSid = "<your-app-sid>",
    AppKey = "<your-app-key>"
};
var oleApi = new OleObjectsApi(config);
var request = new OleObjectUpdateRequest
{
    ImageSourceFullName = "aspose-logo.png",
    IsAutoSize = true,
    SourceFullName = "Sample_Book2.xls",
    UpperLeftRow = 15,
    UpperLeftColumn = 5,
    Left = 10,
    Top = 10,
    Width = 400,
    Height = 400
};

var response = oleApi.UpdateWorksheetOleObject("SampleBook.xlsx", "Sheet1", 0, request, folder: "myFolder");
Console.WriteLine($"Durum: {response.Status}");

Aşağıdaki kod örnekleri, Aspose.Cells web hizmetlerini çeşitli SDK’lar kullanarak nasıl çağıracağınızı göstermektedir:

Excel Çalışma Sayfasına Bir OLE Nesnesi Ekleyin OLE Nesnesini Görüntüye Dönüştür – Aspose.Cells Cloud REST API