在 .NET 中管理簡報的 OLE 物件

簡介

Info

OLE（Object Linking & Embedding）是 Microsoft 的技術，允許在一個應用程式中建立的資料和物件透過連結或嵌入的方式放入另一個應用程式中。

考慮在 MS Excel 中建立的一個圖表，然後將該圖表放入 PowerPoint 投影片中。該 Excel 圖表即被視為 OLE 物件。

OLE 物件可能顯示為圖示。在此情況下，雙擊圖示會在其關聯的應用程式（Excel）中開啟圖表，或會要求您選取用於開啟或編輯物件的應用程式。
OLE 物件也可能直接顯示其實際內容，例如圖表本身。此時圖表在 PowerPoint 中被啟用，圖表介面載入，您可以在 PowerPoint 內修改圖表資料。

Aspose.Slides for .NET 允許您將 OLE 物件插入投影片作為 OLE 物件框架（OleObjectFrame）。

將 OLE 物件框架加入投影片

假設您已在 Microsoft Excel 中建立圖表，並希望使用 Aspose.Slides for .NET 以 OLE 物件框架的方式嵌入至投影片，可參照以下步驟：

建立 Presentation 類別的實例。
透過索引取得投影片的參考。
將 Excel 檔案讀取為位元組陣列。
使用包含位元組陣列及其他 OLE 物件資訊的資料，將 OleObjectFrame 新增至投影片。
將修改後的簡報寫入為 PPTX 檔案。

在下方範例中，我們使用 Aspose.Slides for .NET，將 Excel 檔案中的圖表以 OleObjectFrame 的形式加入投影片。
Note OleEmbeddedDataInfo 建構函式的第二個參數接受可嵌入物件的副檔名。此副檔名讓 PowerPoint 能正確判別檔案類型並選擇適當的應用程式開啟此 OLE 物件。

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

    // 準備 OLE 物件的資料。
    byte[] fileData = File.ReadAllBytes("book.xlsx");
    IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(fileData, "xlsx");

    // 將 OLE 物件框架加入投影片。
    slide.Shapes.AddOleObjectFrame(0, 0, slideSize.Width, slideSize.Height, dataInfo);

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

加入連結 OLE 物件框架

Aspose.Slides for .NET 允許您在不嵌入資料的情況下，只使用檔案連結加入 OleObjectFrame。

以下 C# 程式碼示範如何將帶有連結 Excel 檔案的 OleObjectFrame 新增至投影片：

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

    // 新增一個帶有連結 Excel 檔案的 OLE 物件框架。
    slide.Shapes.AddOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");

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

存取 OLE 物件框架

如果投影片中已嵌入 OLE 物件，您可以依下列方式輕鬆找到或存取它：

透過建立 Presentation 類別的實例，載入含有嵌入 OLE 物件的簡報。
使用索引取得該投影片的參考。
存取 OleObjectFrame 形狀。
在我們的範例中，我們使用先前建立的僅在第一張投影片上只有一個形狀的 PPTX，然後 cast 該物件為 IOleObjectFrame。這就是欲存取的 OLE 物件框架。
一旦取得 OLE 物件框架，即可對其執行任何操作。

在下方範例中，存取了一個 OLE 物件框架（嵌入於投影片的 Excel 圖表物件）及其檔案資料。

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

    // 取得第一個形狀作為 OLE 物件框架。
    IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;

    if (oleFrame != null)
    {
        // 取得嵌入的檔案資料。
        byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;

        // 取得嵌入檔案的副檔名。
        string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;

        // ...
    }
}

存取連結 OLE 物件框架屬性

Aspose.Slides 允許您存取連結 OLE 物件框架的屬性。

以下 C# 程式碼示範如何檢查 OLE 物件是否為連結，並取得連結檔案的路徑：

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

    // 取得第一個形狀作為 OLE 物件框架。
    IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;

    // 檢查 OLE 物件是否為連結。
    if (oleFrame != null && oleFrame.IsObjectLink)
    {
        // 輸出連結檔案的完整路徑。
        Console.WriteLine("OLE object frame is linked to: " + oleFrame.LinkPathLong);

        // 若存在，輸出連結檔案的相對路徑。
        // 只有 PPT 簡報可以包含相對路徑。
        if (!string.IsNullOrEmpty(oleFrame.LinkPathRelative))
        {
            Console.WriteLine("OLE object frame relative path: " + oleFrame.LinkPathRelative);
        }
    }
}

變更 OLE 物件資料

在本節中，以下程式碼範例使用 Aspose.Cells for .NET。

如果投影片中已嵌入 OLE 物件，您可以依下列方式輕鬆存取該物件並修改其資料：

透過建立 Presentation 類別的實例，載入含有嵌入 OLE 物件的簡報。
使用索引取得該投影片的參考。
存取 OLEObjectFrame 形狀。
在我們的範例中，我們使用先前建立的第一張投影片上只有一個形狀的 PPTX，然後 cast 該物件為 IOleObjectFrame。這就是欲存取的 OLE 物件框架。
一旦取得 OLE 物件框架，即可對其執行任何操作。
建立 Workbook 物件並存取 OLE 資料。
取得目標 Worksheet 並修改資料。
將更新後的 Workbook 儲存至串流。
從串流變更 OLE 物件資料。

在下方範例中，存取了一個 OLE 物件框架（嵌入於投影片的 Excel 圖表物件），並修改其檔案資料以更新圖表資料。

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

    // 取得第一個形狀作為 OLE 物件框架。
    IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;

    if (oleFrame != null)
    {
        using (MemoryStream oleStream = new MemoryStream(oleFrame.EmbeddedData.EmbeddedFileData))
        {
            // 將 OLE 物件資料讀取為 Workbook 物件。
            Workbook workbook = new Workbook(oleStream);

            using (MemoryStream newOleStream = new MemoryStream())
            {
                // 修改工作簿資料。
                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);

                // 變更 OLE 框架的物件資料。
                IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(newOleStream.ToArray(), oleFrame.EmbeddedData.EmbeddedFileExtension);
                oleFrame.SetEmbeddedData(newData);
            }
        }
    }

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

在投影片中嵌入其他檔案類型

除了 Excel 圖表外，Aspose.Slides for .NET 還允許您將其他類型的檔案嵌入投影片。例如，您可以將 HTML、PDF 與 ZIP 檔案作為物件插入。使用者雙擊插入的物件時，會自動在相關程式中開啟，或會提示使用者選取適當的程式來開啟。

以下 C# 程式碼示範如何將 HTML 與 ZIP 檔案嵌入投影片：

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

設定嵌入物件的檔案類型

在處理簡報時，您可能需要將舊的 OLE 物件取代為新的，或將不受支援的 OLE 物件換成受支援的類型。Aspose.Slides for .NET 允許您為嵌入的物件設定檔案類型，從而更新 OLE 框架資料或其副檔名。

以下 C# 程式碼示範如何將嵌入 OLE 物件的檔案類型設定為 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}");

    // 將檔案類型變更為 ZIP.
    oleFrame.SetEmbeddedData(new OleEmbeddedDataInfo(fileData, "zip"));

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

設定嵌入物件的圖示與標題

嵌入 OLE 物件後，系統會自動加入一個由圖示組成的預覽。此預覽即為使用者在存取或開啟 OLE 物件前所看到的畫面。若您想在預覽中使用特定的圖像與文字，可透過 Aspose.Slides for .NET 設定圖示與標題。

以下 C# 程式碼示範如何為嵌入的物件設定圖示與標題：

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

    // 將影像加入簡報資源。
    byte[] imageData = File.ReadAllBytes("image.png");
    IPPImage oleImage = presentation.Images.AddImage(imageData);

    // 設定 OLE 預覽的標題與影像。
    oleFrame.SubstitutePictureTitle = "My title";
    oleFrame.SubstitutePictureFormat.Picture.Image = oleImage;
    oleFrame.IsObjectIcon = true;

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

防止 OLE 物件框架被調整大小和重新定位

在將連結 OLE 物件加入簡報投影片後，於 PowerPoint 開啟簡報時，可能會出現要求更新連結的訊息。點選「更新連結」按鈕可能會因 PowerPoint 從連結 OLE 物件更新資料並重新整理預覽，而導致 OLE 物件框架的大小與位置被改變。若要防止 PowerPoint 提示更新物件資料，請將 IOleObjectFrame 介面的 UpdateAutomatic 屬性設為 false：

oleFrame.UpdateAutomatic = false;

提取嵌入的檔案

Aspose.Slides for .NET 允許您依下列方式提取投影片中作為 OLE 物件嵌入的檔案：

建立包含欲提取之 OLE 物件的 Presentation 類別實例。
迭代簡報中所有形狀，存取其中的 OLEObjectFrame 形狀。
取得 OLE 物件框架中嵌入檔案的資料，並寫入磁碟。

以下 C# 程式碼示範如何將投影片中作為 OLE 物件嵌入的檔案提取出來：

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

在將投影片匯出為 PDF/影像時，會渲染 OLE 內容嗎？

會渲染投影片上可見的部分——圖示或替代圖像（預覽）。「即時」的 OLE 內容在渲染過程中不會執行。若需要特定外觀，可自行設定預覽圖像，以確保在匯出的 PDF 中呈現預期的樣子。

如何鎖定投影片上的 OLE 物件，使使用者在 PowerPoint 中無法移動或編輯？

鎖定形狀：Aspose.Slides 提供形狀層級的鎖定。這不是加密，但可有效防止意外的編輯與移動。

為何在開啟簡報時，連結的 Excel 物件會「跳動」或尺寸變化？

PowerPoint 可能會重新整理連結 OLE 的預覽。若想維持穩定外觀，請遵循工作表調整大小的解決方案——將框架調整至範圍大小，或將範圍縮放至固定框架並設定合適的替代圖像。

在 PPTX 格式中，連結 OLE 物件的相對路徑會被保留嗎？

在 PPTX 中不支援「相對路徑」資訊——僅存儲完整路徑。相對路徑僅出現在較舊的 PPT 格式。為提升可移植性，建議使用可靠的絕對路徑或可存取的 URI，或直接嵌入檔案。

在 .NET 中管理簡報可存取性在 .NET 中管理簡報文字