Hantera OLE‑objekt i presentationer i .NET

Introduktion

Tänk dig 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 den associerade applikationen (Excel) när du dubbelklickar på ikonen, eller så uppmanas du att välja en applikation för att öppna eller redigera objektet.
  • Ett OLE‑objekt kan visa sitt faktiska innehåll, t.ex. 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‑objektramar (OleObjectFrame).

Lägg till OLE‑objektramar i bilder

Om du redan har skapat ett diagram i Microsoft Excel och vill bädda in det i en bild som en OLE‑objektram med Aspose.Slides for .NET, kan du göra det på följande sätt:

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

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

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;

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‑objektramar

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.

Den här C#‑koden visar hur du lägger till ett OleObjectFrame med en länkad Excel‑fil på en bild:

using Aspose.Slides;
using Aspose.Slides.Export;

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‑objektramar

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

  1. Läs in en presentation med det inbäddade OLE‑objektet genom att skapa en instans av klassen Presentation .
  2. Hämta referensen till bilden genom att använda dess index.
  3. Kom åt formen OleObjectFrame . I vårt exempel använde vi den tidigare skapade PPTX‑filen som bara har en form på den första bilden. Vi castade sedan det objektet till ett IOleObjectFrame. Detta var den önskade OLE‑objektramen som skulle nås.
  4. När OLE‑objektramen har nåtts kan du utföra vilken operation som helst på den.

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

using Aspose.Slides;

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 den inbäddade filens filändelse.
        string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;

        // ...
    }
}

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

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

Den här C#‑koden visar hur du kontrollerar om ett OLE‑objekt är länkat och sedan får tag i sökvägen till den länkade filen:

using Aspose.Slides;

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

Om ett OLE‑objekt redan är inbäddat i en bild kan du enkelt komma åt det objektet och ändra dess data på följande sätt:

  1. Läs in en presentation med det inbäddade OLE‑objektet genom att skapa en instans av klassen Presentation .
  2. Hämta bildens referens via dess index.
  3. Kom åt 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 ett IOleObjectFrame. Detta var den önskade OLE‑objektramen som skulle nås.
  4. När OLE‑objektramen har nåtts kan du utföra vilken operation som helst på den.
  5. Skapa ett Workbook‑objekt och hämta OLE‑data.
  6. Kom åt önskat Worksheet och ändra datan.
  7. Spara den uppdaterade Workbook i en ström.
  8. Ändra OLE‑objektdata från strömmen.

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

using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;

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-objektdata som ett Workbook-objekt.
            Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(oleStream);

            using (MemoryStream newOleStream = new MemoryStream())
            {
                // Ändra data i arbetsboken.
                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);

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

                // Ändra OLE-objektramens data.
                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 typer av filer 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å uppmanas användaren att välja ett lämpligt program för att öppna det.

Den här C#‑koden visar hur du bäddar in HTML och ZIP i en bild:

using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;

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ödd. Aspose.Slides for .NET låter dig ange filtypen för ett inbäddat objekt, vilket gör att du kan uppdatera OLE‑ramens data eller dess extension.

Den här C#‑koden visar hur du sätter filtypen för ett inbäddat OLE‑objekt till zip:

using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;

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 en förhandsgranskning bestående av en ikonbild automatiskt till. Denna förhandsgranskning är vad användarna ser innan de öppnar eller får åtkomst till 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.

Den här C#‑koden visar hur du anger ikonbild och titel för ett inbäddat objekt:

using Aspose.Slides;
using Aspose.Slides.Export;

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);
}

Förhindra att en OLE‑objektram ändras i storlek och flyttas

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

using Aspose.Slides;
using Aspose.Slides.Export;

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

    // Behåll OLE-objektramens storlek och position när PowerPoint uppdaterar länken.
    oleFrame.UpdateAutomatic = false;

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

Extrahera inbäddade filer

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

  1. Skapa en instans av klassen Presentation som innehåller de OLE‑objekt du avser att extrahera.
  2. Loopa igenom alla former i presentationen och kom åt formerna OLEObjectFrame.
  3. Hämta data för inbäddade filer från OLE‑objektramar och skriv den till disk.

Den här C#‑koden visar hur du extraherar filer som är inbäddade i en bild som OLE‑objekt:

using Aspose.Slides;

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 – ikonen/ersättningsbilden (förhandsgranskning). Det “levande” OLE‑innehållet körs inte under rendering. Vid behov kan du ange en egen förhandsgranskningsbild för att säkerställa önskat utseende i den exporterade PDF‑filen.

För att även bevara den inbäddade filen som en PDF‑bilaga, sätt PdfOptions.IncludeOleData till true. Detta alternativ är inaktiverat som standard. För ett exempel och instruktioner för att kontrollera bilagan, se Preserve Embedded OLE Files as PDF Attachments.

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 erbjuder shape-level locks. Detta är ingen kryptering, men det hindrar effektivt oavsiktliga redigeringar och flyttningar.

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

PowerPoint kan uppdatera förhandsgranskningen av den länkade OLE:n. För ett stabilt utseende, följ bästa praxis i Working Solution for Worksheet Resizing – antingen anpassa ramen till området, eller skala området 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” – bara den fullständiga sökvägen. Relativa sökvägar finns i det äldre PPT‑formatet. För portabilitet, föredra pålitliga absoluta sökvägar/tillgängliga URI:er eller inbäddning.