Hantera OLE-objekt i presentationer i .NET

Introduktion

Info

OLE (Object Linking & Embedding) är en Microsoft‑teknik som tillåter data och objekt skapade i ett program att placeras i ett annat program via länkning eller inbäddning.

Tänk på ett diagram skapat i MS Excel. Diagrammet placeras sedan i en PowerPoint‑bild. Det Excel‑diagrammet betraktas som ett OLE‑objekt.

Ett OLE‑objekt kan visas som en ikon. I så fall öppnas diagrammet i det tillhörande programmet (Excel) när du dubbelklickar på ikonen, eller så blir du ombedd att välja ett program för att öppna eller redigera objektet.
Ett OLE‑objekt kan visa sitt faktiska innehåll, till exempel innehållet i ett diagram. I så fall aktiveras diagrammet i PowerPoint, diagramgränssnittet laddas och du kan ändra diagrammets data i PowerPoint.

Aspose.Slides for .NET låter dig infoga OLE‑objekt i bilder som OLE‑objekt‑ramar (OleObjectFrame).

Lägg till OLE‑objekt‑ramar i bilder

Anta att du redan har skapat ett diagram i Microsoft Excel och vill bädda in det i en bild som en OLE‑objekt‑ram med Aspose.Slides for .NET, så kan du göra så här:

Skapa en instans av klassen Presentation.
Hämta en bilds referens via dess index.
Läs Excel‑filen som en byte‑array.
Lägg till OleObjectFrame på bilden med byte‑arrayen och annan information om OLE‑objektet.
Skriv den modifierade presentationen som en PPTX‑fil.

I exemplet nedan lade vi till ett diagram från en Excel‑fil på en bild som ett OleObjectFrame med Aspose.Slides for .NET.
Obs att konstruktorn för OleEmbeddedDataInfo tar en inbäddningsbar objekt‑extension som andra parameter. Denna extension låter PowerPoint tolka filtypen korrekt och välja rätt program för att öppna detta OLE‑objekt.

using (Presentation presentation = new Presentation())
{
    SizeF slideSize = presentation.SlideSize.Size;
    ISlide slide = presentation.Slides[0];

    // Förbered data för OLE-objektet.
    byte[] fileData = File.ReadAllBytes("book.xlsx");
    IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(fileData, "xlsx");

    // Lägg till OLE-objektramen på bilden.
    slide.Shapes.AddOleObjectFrame(0, 0, slideSize.Width, slideSize.Height, dataInfo);

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Lägg till länkade OLE‑objekt‑ramar

Aspose.Slides for .NET låter dig lägga till ett OleObjectFrame utan att bädda in data, utan bara med en länk till filen.

Denna C#‑kod visar hur du lägger till ett OleObjectFrame med en länkad Excel‑fil på en bild:

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    // Lägg till en OLE-objektram med en länkad Excel-fil.
    slide.Shapes.AddOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Åtkomst till OLE‑objekt‑ramar

Om ett OLE‑objekt redan är inbäddat i en bild kan du enkelt hitta eller komma åt det på följande sätt:

Läs in en presentation med det inbäddade OLE‑objektet genom att skapa en instans av klassen Presentation.
Hämta bildens referens med hjälp av dess index.
Åtkom formen OleObjectFrame. I vårt exempel använde vi den tidigare skapade PPTX‑filen som har endast en form på den första bilden. Vi castade sedan det objektet till en IOleObjectFrame. Detta var den önskade OLE‑objekt‑ramen som skulle nås.
När OLE‑objekt‑ramen har nåtts kan du utföra valfri operation på den.

I exemplet nedan nås en OLE‑objekt‑ram (ett Excel‑diagramobjekt inbäddat i en bild) och dess fildata.

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // Hämta den första formen som en OLE-objektram.
    IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;

    if (oleFrame != null)
    {
        // Hämta den inbäddade fildatan.
        byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;

        // Hämta filändelsen för den inbäddade filen.
        string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;

        // ...
    }
}

Åtkomst till egenskaper för länkad OLE‑objekt‑ram

Aspose.Slides låter dig komma åt egenskaper för länkade OLE‑objekt‑ramar.

Denna C#‑kod visar hur du kontrollerar om ett OLE‑objekt är länkat och sedan hämtar sökvägen till den länkade filen:

using (Presentation presentation = new Presentation("sample.ppt"))
{
    ISlide slide = presentation.Slides[0];

    // Hämta den första formen som en OLE-objektram.
    IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;

    // Kontrollera om OLE-objektet är länkat.
    if (oleFrame != null && oleFrame.IsObjectLink)
    {
        // Skriv ut den fullständiga sökvägen till den länkade filen.
        Console.WriteLine("OLE object frame is linked to: " + oleFrame.LinkPathLong);

        // Skriv ut den relativa sökvägen till den länkade filen om den finns.
        // Endast PPT-presentationer kan innehålla den relativa sökvägen.
        if (!string.IsNullOrEmpty(oleFrame.LinkPathRelative))
        {
            Console.WriteLine("OLE object frame relative path: " + oleFrame.LinkPathRelative);
        }
    }
}

Ändra OLE‑objektdata

I detta avsnitt använder kodexemplet nedan Aspose.Cells for .NET.

Om ett OLE‑objekt redan är inbäddat i en bild kan du på detta sätt enkelt nå objektet och ändra dess data:

Läs in en presentation med det inbäddade OLE‑objektet genom att skapa en instans av klassen Presentation.
Hämta bildens referens via dess index.
Åtkom formen OLEObjectFrame. I vårt exempel använde vi den tidigare skapade PPTX‑filen som har en form på den första bilden. Vi castade sedan objektet till en IOleObjectFrame. Detta var den önskade OLE‑objekt‑ramen som skulle nås.
När OLE‑objekt‑ramen har nåtts kan du utföra vilken operation som helst på den.
Skapa ett Workbook‑objekt och få åtkomst till OLE‑data.
Åtkom det önskade Worksheet och ändra datan.
Spara det uppdaterade Workbook i en ström.
Ändra OLE‑objektdata från strömmen.

I exemplet nedan nås en OLE‑objekt‑ram ( ett Excel‑diagramobjekt inbäddat i en bild) och dess fildata modifieras för att uppdatera diagrammets data.

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // Hämta den första formen som en OLE-objektram.
    IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;

    if (oleFrame != null)
    {
        using (MemoryStream oleStream = new MemoryStream(oleFrame.EmbeddedData.EmbeddedFileData))
        {
            // Läs OLE-objektets data som ett Workbook-objekt.
            Workbook workbook = new Workbook(oleStream);

            using (MemoryStream newOleStream = new MemoryStream())
            {
                // Modifiera arbetsbokens data.
                workbook.Worksheets[0].Cells[0, 4].PutValue("E");
                workbook.Worksheets[0].Cells[1, 4].PutValue(12);
                workbook.Worksheets[0].Cells[2, 4].PutValue(14);
                workbook.Worksheets[0].Cells[3, 4].PutValue(15);

                OoxmlSaveOptions fileOptions = new OoxmlSaveOptions(Aspose.Cells.SaveFormat.Xlsx);
                workbook.Save(newOleStream, fileOptions);

                // Ändra OLE-ramens objektdata.
                IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(newOleStream.ToArray(), oleFrame.EmbeddedData.EmbeddedFileExtension);
                oleFrame.SetEmbeddedData(newData);
            }
        }
    }

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Bädda in andra filtyper i bilder

Förutom Excel‑diagram låter Aspose.Slides for .NET dig bädda in andra filtyper i bilder. Till exempel kan du infoga HTML-, PDF- och ZIP‑filer som objekt. När en användare dubbelklickar på det infogade objektet öppnas det automatiskt i det relevanta programmet, eller så blir användaren ombedd att välja ett lämpligt program för att öppna det.

Denna C#‑kod visar hur du bäddar in HTML och ZIP i en bild:

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    byte[] htmlData = File.ReadAllBytes("sample.html");
    IOleEmbeddedDataInfo htmlDataInfo = new OleEmbeddedDataInfo(htmlData, "html");
    IOleObjectFrame htmlOleFrame = slide.Shapes.AddOleObjectFrame(150, 120, 50, 50, htmlDataInfo);
    htmlOleFrame.IsObjectIcon = true;

    byte[] zipData = File.ReadAllBytes("sample.zip");
    IOleEmbeddedDataInfo zipDataInfo = new OleEmbeddedDataInfo(zipData, "zip");
    IOleObjectFrame zipOleFrame = slide.Shapes.AddOleObjectFrame(150, 220, 50, 50, zipDataInfo);
    zipOleFrame.IsObjectIcon = true;

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Ange filtyper för inbäddade objekt

När du arbetar med presentationer kan du behöva ersätta gamla OLE‑objekt med nya eller ersätta ett ej‑stödd OLE‑objekt med ett stödt. Aspose.Slides for .NET låter dig ange filtypen för ett inbäddat objekt, vilket möjliggör att uppdatera OLE‑ramens data eller dess extension.

Denna C#‑kod visar hur du anger filtypen för ett inbäddat OLE‑objekt till zip:

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IOleObjectFrame oleFrame = (IOleObjectFrame)slide.Shapes[0];

    string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;
    byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;

    Console.WriteLine($"Current embedded file extension is: {fileExtension}");

    // Ändra filtypen till ZIP.
    oleFrame.SetEmbeddedData(new OleEmbeddedDataInfo(fileData, "zip"));

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Ange ikonbilder och titlar för inbäddade objekt

Efter att ett OLE‑objekt har bäddats in läggs automatiskt en förhandsgranskning bestående av en ikonbild till. Denna förhandsgranskning är vad användarna ser innan de åtkommer till eller öppnar OLE‑objektet. Om du vill använda en specifik bild och text som element i förhandsgranskningen kan du ange ikonbilden och titeln med Aspose.Slides for .NET.

Denna C#‑kod visar hur du anger ikonbilden och titeln för ett inbäddat objekt:

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IOleObjectFrame oleFrame = (IOleObjectFrame)slide.Shapes[0];

    // Lägg till en bild i presentationens resurser.
    byte[] imageData = File.ReadAllBytes("image.png");
    IPPImage oleImage = presentation.Images.AddImage(imageData);

    // Ange en titel och bilden för OLE-förhandsgranskningen.
    oleFrame.SubstitutePictureTitle = "My title";
    oleFrame.SubstitutePictureFormat.Picture.Image = oleImage;
    oleFrame.IsObjectIcon = true;

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Prevent an OLE Object Frame from Being Resized and Pepositioned

När du har lagt till ett länkat OLE‑objekt på en presentationsbild och öppnar presentationen i PowerPoint kan du få ett meddelande som ber dig uppdatera länkarna. Klickar du på knappen “Update Links” kan storlek och position för OLE‑objekt‑ramen ändras eftersom PowerPoint uppdaterar data från det länkade OLE‑objektet och uppdaterar förhandsgranskningen. För att förhindra att PowerPoint uppmanar dig att uppdatera objektets data, sätt egenskapen UpdateAutomatic för gränssnittet IOleObjectFrame till false:

oleFrame.UpdateAutomatic = false;

Extrahera inbäddade filer

Aspose.Slides for .NET låter dig extrahera filer som är inbäddade i bilder som OLE‑objekt på följande sätt:

Skapa en instans av klassen Presentation som innehåller de OLE‑objekt du vill extrahera.
Loop igenom alla former i presentationen och åtkom OLEObjectFrame-formerna.
Åtkom datan för inbäddade filer från OLE‑objekt‑ramarna och skriv den till disk.

Denna C#‑kod visar hur du extraherar filer som är inbäddade i en bild som OLE‑objekt:

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];

    for (int index = 0; index < slide.Shapes.Count; index++)
    {
        IShape shape = slide.Shapes[index];
        IOleObjectFrame oleFrame = shape as IOleObjectFrame;

        if (oleFrame != null)
        {
            byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;
            string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;

            string filePath = $"OLE_object_{index}{fileExtension}";
            File.WriteAllBytes(filePath, fileData);
        }
    }
}

FAQ

Kommer OLE‑innehållet att renderas när bilder exporteras till PDF/bilder?

Det som är synligt på bilden renderas – ikon-/ersättningsbilden (förhandsgranskning). Det “levande” OLE‑innehållet körs inte under rendering. Vid behov, ange din egen förhandsgranskningsbild för att säkra det förväntade utseendet i den exporterade PDF‑filen.

Hur kan jag låsa ett OLE‑objekt på en bild så att användare inte kan flytta/redigera det i PowerPoint?

Lås formen: Aspose.Slides tillhandahåller formnivå‑låsning. Detta är inte kryptering, men det förhindrar effektivt oavsiktliga redigeringar och förflyttningar.

Varför “hoppar” eller ändrar storlek ett länkat Excel‑objekt när jag öppnar presentationen?

PowerPoint kan uppdatera förhandsgranskningen av det länkade OLE‑objektet. För ett stabilt utseende, följ rekommendationerna i Working Solution for Worksheet Resizing – anpassa antingen ramen till intervallet, eller skala intervallet till en fast ram och ange en lämplig ersättningsbild.

Kommer relativa sökvägar för länkade OLE‑objekt att bevaras i PPTX‑formatet?

I PPTX finns ingen information om “relativ sökväg” – endast den fullständiga sökvägen. Relativa sökvägar finns i det äldre PPT‑formatet. För portabilitet bör du föredra pålitliga absoluta sökvägar/tillgängliga URI:er eller bädda in.

Hantera presentationstillgänglighet i .NET Hantera presentationstext i .NET