Uppdatera ett OLE-objekt i ett Excel-ark – Aspose.Cells Cloud API-guide

Denna REST API uppdaterar ett OLE-objekt i ett Excel-ark.

Säkerhet och autentisering

Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.

PostUpdateWorksheetOleObject API

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

Följande parametrar används i begäran:

Parameternamn Typ Parametrplats Beskrivning
name string path Arbetsbokens namn.
sheetName string path Arkets namn.
oleObjectIndex integer path Index för OLE-objektet inom arket.
ole object body JSON-representation av det OLE-objekt som ska uppdateras.
folder string query Mappen som innehåller arbetsboken.
storageName string query Namnet på lagringstjänsten.

Fält i begärandetexten

Fält Typ Obligatoriskt Beskrivning
ImageSourceFullName string valfritt Sökvägen till den bildfil som används för OLE-objektet.
IsAutoSize boolean valfritt Om OLE-objektet ska automatiskt anpassas i storlek.
SourceFullName string obligatoriskt Källfilen (t.ex. en bild eller ett diagram) för OLE-objektet.
UpperLeftRow integer obligatoriskt Radindex (nollbaserat) för övre vänstra hörnet.
UpperLeftColumn integer obligatoriskt Kolumnindex (nollbaserat) för övre vänstra hörnet.
Left integer valfritt Horisontell offset, i punkter, från övre vänstra hörnet.
Top integer valfritt Vertikal offset, i punkter, från övre vänstra hörnet.
Width integer obligatoriskt Bredden på OLE-objektet, i punkter.
Height integer obligatoriskt Höjden på OLE-objektet, i punkter.

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och möjliggör REST-interaktioner direkt från en webbläsare.

Du kan använda kommandoradsverktyget cURL för enkelt att komma åt Aspose.Cells-webbtjänster. Följande exempel visar hur du anropar Cloud API:et med cURL.

Felaktiga svar

HTTP-status Kod Meddelande
400 4000 Felaktig begäran – saknade eller ogiltiga parametrar.
401 4010 Inte auktoriserad – ogiltig eller saknad JWT-token.
404 4040 Ej funnen – arbetsboken, arket eller OLE-objektet finns inte.
500 5000 Internt serverfel – oväntat fel på serversidan.

API:et returnerar även ett anpassat Code-fält i svarstexten som motsvarar HTTP-statuskoden (t.ex. 200 → 2000, 400 → 4000 etc.).

När ska du använda detta API?

Använd detta slutsteg när du behöver ändra ett befintligt OLE-objekt – såsom en inbäddad bild, ett diagram eller ett dokument – utan att ladda upp hela arket på nytt. Vanliga användningsfall inkluderar att uppdatera källfilen för en bild, ändra objektets storlek eller ändra dess position efter att arbetsboken har genererats. Se även Lägg till ett OLE-objekt och Ta bort ett OLE-objekt för relaterade åtgärder.

Moln-SDK-familj

Att använda en SDK är det snabbaste sättet att utveckla. En SDK abstraherar bort detaljer på lågnivå så att du kan fokusera på ditt projekt. Besök GitHub-lagret för en komplett lista över Aspose.Cells Cloud SDK:er.

Nedan följer ett kort C#-exempel som uppdaterar ett OLE-objekt med 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}");

Följande kodexempel visar hur man anropar Aspose.Cells-webbtjänster med olika SDK:er:

Lägg till ett OLE-objekt i ett Excel-arbetsblad Konvertera OLE-objekt till bild – Aspose.Cells Cloud REST API