Ein OLE-Objekt in einer Excel-Arbeitsmappe aktualisieren – Aspose.Cells Cloud API-Anleitung

Diese REST API aktualisiert ein OLE-Objekt in einer Excel-Arbeitsmappe.

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

PostUpdateWorksheetOleObject API

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

Die Anfrageparameter sind:

Parametername Typ Parameterposition Beschreibung
name string path Der Name der Arbeitsmappe.
sheetName string path Der Name des Arbeitsblatts.
oleObjectIndex integer path Index des OLE-Objekts innerhalb des Arbeitsblatts.
ole object body JSON-Darstellung des zu aktualisierenden OLE-Objekts.
folder string query Der Ordner, der die Arbeitsmappe enthält.
storageName string query Der Name des Speicherdienstes.

Felder im Anforderungstext

Feld Typ Erforderlich Beschreibung
ImageSourceFullName string optional Pfad zur Bilddatei, die für das OLE-Objekt verwendet wird.
IsAutoSize boolean optional Gibt an, ob das OLE-Objekt automatisch dimensioniert wird.
SourceFullName string erforderlich Die Quelldatei (z. B. ein Bild oder Diagramm) für das OLE-Objekt.
UpperLeftRow integer erforderlich Zeilenindex (nullbasiert) der oberen linken Ecke.
UpperLeftColumn integer erforderlich Spaltenindex (nullbasiert) der oberen linken Ecke.
Left integer optional Horizontaler Versatz in Punkten von der oberen linken Ecke.
Top integer optional Vertikaler Versatz in Punkten von der oberen linken Ecke.
Width integer erforderlich Breite des OLE-Objekts in Punkten.
Height integer erforderlich Höhe des OLE-Objekts in Punkten.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser heraus durchzuführen.

Sie können das Befehlszeilentool cURL verwenden, um problemlos auf Aspose.Cells-Webservices zuzugreifen. Das folgende Beispiel zeigt, wie die Cloud-API mit cURL aufgerufen wird.

Fehlerantworten

HTTP-Status Code Nachricht
400 4000 Bad Request – fehlende oder ungültige Parameter.
401 4010 Unauthorized – ungültiges oder fehlendes JWT-Token.
404 4040 Not Found – Arbeitsmappe, Arbeitsblatt oder OLE-Objekt existiert nicht.
500 5000 Internal Server Error – unerwarteter Fehler auf Serverseite.

Die API gibt im Antworttext auch ein benutzerdefiniertes Feld Code zurück, das dem HTTP-Status zugeordnet ist (z. B. 200 → 2000, 400 → 4000 usw.).

Wann diese API verwenden?

Verwenden Sie diesen Endpunkt, wenn Sie ein vorhandenes OLE-Objekt – beispielsweise ein eingebettetes Bild, Diagramm oder Dokument – ändern möchten, ohne die gesamte Arbeitsmappe erneut hochzuladen. Typische Szenarien sind die Aktualisierung der Bildquelle, das Ändern der Größe des Objekts oder das Ändern seiner Position nach der Erstellung der Arbeitsmappe. Weitere verwandte Vorgänge finden Sie unter Ein OLE-Objekt hinzufügen und Ein OLE-Objekt löschen.

Cloud SDK-Familie

Die Verwendung eines SDKs ist die schnellste Möglichkeit zur Entwicklung. Ein SDK abstractiert Low-Level-Details, sodass Sie sich auf Ihr Projekt konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Im Folgenden finden Sie ein kurzes C#-Beispiel zur Aktualisierung eines OLE-Objekts mithilfe des Aspose.Cells Cloud SDK:

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($"Status: {response.Status}");

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mithilfe verschiedener SDKs aufgerufen werden:

Ein OLE-Objekt in einem Excel-Arbeitsblatt hinzufügen OLE-Objekt in Bild konvertieren – Aspose.Cells Cloud REST API