Word .NET庫組件Spire.Doc系列教程（44）：在C# Word 中添加、修改和提取 OLE

Spire.Doc for .NET是一個專業的Word .NET庫，設計用于幫助開發人員高效地開發創建、閱讀、編寫、轉換和打印任何來自.NET( C#, VB.NET, ASP.NET）平臺的Word文檔文件的功能。

本系列教程將為大家帶來Spire.Doc for .NET在使用過程中的各類實際操作，本文將講解如何在C# Word 中添加、修改和提取 OLE。

點擊下載最新版Spire.Doc for .NET

12月優惠進行時，Spire.Office套包優惠7170元起，心動就趕快吧！

推薦閱讀：【想要快速完成文檔格式轉換嗎？Spire系列組件格式轉換完整攻略來啦！】

OLE（Object Linking and Embedding，對象連接與嵌入）是一種面向對象的技術。OLE分為兩種形式，一種是嵌入，一種是鏈接。前者是將對象嵌入到文檔中，不管外部對象怎么更改都是以嵌入操作當時的對象為準，之后不再改變。而后者是以鏈接形式來保存對象的，外部任何對該對象的更改都會影響文檔。Spire.Doc支持Word中的OLE操作，包括添加，修改和提取OLE對象，本文將對此做詳細介紹。

添加OLE

//實例化一個Document對象
Document doc = new Document();
//向文檔中添加一個Section對象
Section sec = doc.AddSection();

//在這個section上添加一個段落
Paragraph p = sec.AddParagraph();

//實例化一個DocPicture對象
DocPicture picture = new DocPicture(doc);

//目前我們還沒有實現自動掃描成圖標的功能， 只能手動用圖片去設置圖標
//事實上，我們每個產品都支持將文檔保存成圖片，可以巧妙地加以利用。
//這里我加載的圖片是通過Spire.XLS 的SaveToImage方法得到的。
Image image = Image.FromFile(@"C:\Users\Administrator\Desktop\ole.png");
picture.LoadImage(image);

//在文檔中插入一個工作表, OleLinkType 枚舉值控制該OLE是鏈接還是嵌入
DocOleObject obj = p.AppendOleObject(@"jane.xlsx", picture, OleLinkType.Link);
//DocOleObject obj = p.AppendOleObject(@"jane.xlsx", picture, OleLinkType.Embed);

//保存文檔
doc.SaveToFile("添加OLE.docx");

向文檔中順利添加了一個Excel工作表：

修改OLE

//實例化一個Document對象
 Document doc = new Document();

 //加載一個有OLE對象的文檔
 doc.LoadFromFile(@"添加OLE.docx");

 //獲取第一個Section
 Section sec = doc.Sections[0];

 //遍歷這個Section中的所有子元素，找到段落下的OLE對象
 foreach (DocumentObject obj in sec.Body.ChildObjects)
 {
     if (obj is Paragraph)
     {
         Paragraph par = obj as Paragraph;
         foreach (DocumentObject paraObj in par.ChildObjects)
         {
             //找到OLE對象，根據類型來進行更改操作
             if (paraObj.DocumentObjectType == DocumentObjectType.OleObject)
             {
                 DocOleObject Ole = paraObj as DocOleObject;
                 //如果是鏈接， 修改對象的鏈接路徑
                 if (Ole.LinkType == OleLinkType.Link)
                 {
                     //同時還要手動去更改OLE的圖片
                     DocPicture pic = Ole.OlePicture;
                     pic.LoadImage(Image.FromFile(@"WordOle.png"));
                     Ole.LinkPath = @"替換的Word文檔.docx";
                 }
                 //如果是嵌入，更改數據即可
                 byte[] bys = File.ReadAllBytes(@"替換的Word文檔.docx");
                 if (Ole.LinkType == OleLinkType.Embed)
                 {
                     DocPicture pic = new DocPicture(doc);
                     pic.LoadImage(Image.FromFile(@"WordOle.png"));
                     Ole.ObjectType = "Word.Document.12";
                     Ole.SetOlePicture(pic);
                     Ole.SetNativeData(bys);
                 }
             }
         }
     }
 }
 doc.SaveToFile("修改OLE.docx", Spire.Doc.FileFormat.Docx2013);

將原來文檔中的excel工作表替換成了Word文檔：

提取OLE

//實例化一個Document對象
Document doc = new Document();

//加載一個有OLE對象的文檔
doc.LoadFromFile(@"添加OLE.docx ");

//遍歷文檔所有Section          
foreach (Section sec in doc.Sections)
{
    //遍歷Section下面所有的子元素
    foreach (DocumentObject obj in sec.Body.ChildObjects)
    {
        if (obj is Paragraph)
        {
            Paragraph par = obj as Paragraph;
            //遍歷這個section下面的段落
            foreach (DocumentObject o in par.ChildObjects)
            {
                //找到OLE對象，并根據類型提取
                if (o.DocumentObjectType == DocumentObjectType.OleObject)
                {
                    DocOleObject Ole = o as DocOleObject;
                    //ObjectType屬性可以獲取ole對象的具體類型。
                    //注意，如果是用Spire.Doc添加的ole對象的話，需要在AppendOleObject
                    //的時候先聲明OleObjectType，不然這里得不到具體的類型，只會得到Package
                    string s = Ole.ObjectType;
                    //"AcroExch.Document.11"是指PDF對象對應的ProgID
                    if (s == "AcroExch.Document.11")
                    {
                        File.WriteAllBytes("Result.pdf", Ole.NativeData);
                    }
                    //"Excel.Sheet.12"是指 Excel03之后的工作表對應的ProgID
                    else if (s == "Excel.Sheet.12")
                    {
                        File.WriteAllBytes("Result.xlsx", Ole.NativeData);
                    }
                    //"Word.Document.12"是指03之后的Word對應的ProgID
                    else if (s == "Word.Document.12")
                    {
                        File.WriteAllBytes("Result.docx", Ole.NativeData);
                    }
                }
            }
        }
    }
}

提取出來的excel工作表如下：