[Office]使用 OpenXML SDK 建立 Word 文件檔

来源：互联网发布：常用sql查询语句编辑：程序博客网时间：2024/04/27 23:18

一、簡介

在 Microsoft Office 2007 版本以後的原始文件格式為 Open XML，Open XML 是一種 Ecma 標準，其中文字處理檔案的標記語言稱為 WordprocessingML。本文說明如何使用 OpenXML SDK 建立 Word 檔以及 WordprocessingML 的結構。

關於如何在 Visual Studio 2008 專案加入 Open XML SDK 參考，請參考先前的文章 [Office][C#] NPOI、OpenXML SDK、OpenOffice.org SDK 寫入資料到 EXCEL 檔案。

並先於專案前 using 相關 namespace

using DocumentFormat.OpenXml;using DocumentFormat.OpenXml.Packaging;using DocumentFormat.OpenXml.Wordprocessing;

二、WordprocessingDocument 類別

在 OpenXML SDK 中，WordprocessingDocument 類別作為 Word 文件封包。要建立 Word 文件，必須先實例化 WordprocessingDocument 類別並且將資料填入。要填入的資料最少要包含 WordprocessingML 主文件部分必要結構。我們可以透過 WordprocessingDocument 類別中的 Create 方法建立 Word 文件，其中最簡單的多載是傳入兩個參數，分別是 filePath (檔案路徑名稱) 與 WordprocessingDocumentType (Word 文件類型)。

string filepath = @"C:\test.xlsx";WordprocessingDocument wordDocument = WordprocessingDocument.Create(filepath, WordprocessingDocumentType.Document);

在 WordprocessingDocumentType 部分，可以指定的文件類型有 :

Document : Word 文件 (*.docx)
MacroEnabledDocument : Word 啟用巨集的文件 (*.docm)
MacroEnabledTemplate : Word 啟用巨集的範本 (*.dotm)
Template : Word 範本(*.dotx)

請注意檔案副檔名需配合 WordprocessingDocumentType，否則透過 Microsoft Office 開啟檔案會判斷錯誤。在程式撰寫上，MSDN 建議使用 using 的方式，好處是在程式執行完離開括號時會自動做 Dispose() 資源釋放，如以下程式碼所示 :

string filepath = @"C:\test.xlsx";WordprocessingDocument wordDocument = WordprocessingDocument.Create(filepath, WordprocessingDocumentType.Document){    // 插入其它程式碼}

產生 Word 文件封包後，使用 WordprocessingDocument 類別中的 AddMainDocumentPart 方法填入主文件部分，之後就可以將 Word 相關結構與文字陸續加入。對於 OpenXML WordProcessingML 文件格式而言，最基本的是 document 和 body 元素。document 包含文件主要宣告http://schemas.openxmlformats.org/wordprocessingml/2006/main namespace，通常簡寫為 w，緊接著是 body 本文內容，而我們可以在 body 中加入多個段落 Paragraph (P)，並在每個段落中加入不同的文字屬性 Run (R) 範圍，並填入文字資料 Text (t)

舉個例子，如下的 docx Word 文件檔案

其 WordprocessingML 如下所示 :

<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">  <w:body>    <w:p>      <w:r>        <w:t>在 body 本文內容產生 text 文字</w:t>      </w:r>    </w:p>  </w:body></w:document>

在 OpenXML SDK 2.0 產生 WordprocessingML 元素結構，可以使用 DocumentFormat.OpenXml.Wordprocessing namespace 來產生對應結構，參考下表 :

WordprocessingML 元素Open XML SDK 2.0 類別描述documentDocument主文件宣告bodyBody本文的內容pParagraph一個段落rRun一群屬性相同文字範圍tText文字內容

三、程式撰寫

接著透過 OpenXML SDK 2.0 產生檔名為 text.docx 的 Word 文件，文件內容如下所示 :

請參考程式碼與註解說明，並配合先前 WordprocessingML 元素結構。

// 檔案路徑檔名、請注意副檔名與 WordprocessingDocumentType.Document 一致string filepath = @"C:\test.docx";// 建立 WordprocessingDocument 類別，透過 WordprocessingDocument 類別中的 Create 方法建立 Word 文件using (WordprocessingDocument wordDocument = WordprocessingDocument.Create(filepath, WordprocessingDocumentType.Document)){    // 建立 MainDocumentPart 類別物件 mainPart，加入主文件部分     MainDocumentPart mainPart = wordDocument.AddMainDocumentPart();    // 實例化 Document(w) 部分    mainPart.Document = new Document();    // 建立 Body 類別物件，於加入 Doucment(w) 中加入 Body 內文    Body body = mainPart.Document.AppendChild(new Body());    // 建立 Paragraph 類別物件，於 Body 本文中加入段落 Paragraph(p)    Paragraph paragraph = body.AppendChild(new Paragraph());    // 建立 Run 類別物件，於 段落 Paragraph(p) 中加入文字屬性 Run(r) 範圍    Run run = paragraph.AppendChild(new Run());    // 在文字屬性 Run(r) 範圍中加入文字內容    run.AppendChild(new Text("在 body 本文內容產生 text 文字"));}

四、結語

本文說明使用 OpenXML SDK 2.0 產生 Word 文件檔案，並針對 WordprocessingML 結構進行說明，了解這些知識對於之後編輯 Word 文件與程式除錯會有幫助。

五、相關參考

MSDN - How to: Create a Word Processing Document by Providing a Filename

MSDN - WordprocessingML 文件的組織結構

X's Blog - WORD 2007 WordprocessingML (Part 1)

http://msdn.microsoft.com/zh-tw/library/bb669147(v=VS.90).aspx#Y914

http://msdn.microsoft.com/en-us/library/ff478190(v=office.14).aspx#Y508