使用Asponse.Words處理Word模板

　　一.客戶需求

　　　　近期接到一個專案，在與客戶初步溝通後，客戶描述的需求聽起來也非常簡單，就是目前客戶需要在Excel錄入資料，然後把這些資料分別複製到多個Word的多個地方，除了單個值之外，還需要複製表格資料以及圖片資料，客戶覺得這麼操作一是容易出錯，二是重複操作的工作量太大。在初步瞭解使用者的需求之後，得知客戶需求的核心功能就是在Word中填充資料來源，需要填充資料的資料來源包括文字，表格以及圖片等，本文以此為出發點，重點介紹如何在Word中使用“域”來填充外部資料。

　　二.外掛選型

　　　　目前處理Word等Office文件型別的控制元件，微軟自帶的Com元件問題實在太多，一個比較麻煩的問題就是部分Com元件需要註冊，並且如果客戶端與開發電腦使用的Com元件版本不一致，還會出現各種問題，因此選擇了Asponse.words外掛，該軟體為收費外掛，具體的收費標準可以在官網進行檢視。

　　三.模板製作

　　　　利用Asponse進行資料填充，其實程式碼不難，核心的工作就是需要在Word模板中設定標記，也就是需要讓程式知道在什麼地方填充資料，目前做標記的方式有兩種，一種是使用書籤，一種是使用域。目前網上大多的案例都是使用書籤，但是在我實際開發的過程中，建議大家使用“域”，而不是使用書籤，原因有以下幾點：

　　　　1.書籤不能重複新增，比如我在第一個空白出需要插入資料來源“姓名”，在最後簽名處還要插入“姓名”，這個時候使用“域”的話可以在兩處都插入“姓名”域，但是如果使用書籤，需要設定不同的書籤名稱，生成資料來源的時候會增加工作量

　　　　2.書籤不能在文件中直觀的展示出來，如果插入書籤比較多，很容易造成混亂

　　　　此外，需要特別說明的是，製作書籤或者“域"的時候務必務必使用Word而不是WPS製作，因為目前發現的一個問題就是，使用WPS製作的書籤或者是”域“，在填充資料之後會自動增加一行空行，這個可能是WPS與Word的內部機制不同；還有一個技巧，在文件中使用Alt+F9,可以檢視到模板的各種域程式碼，如下圖所示：

　　　　

　　四.插入書籤/域

　　　　1.插入書籤　　　　

　　　　

　　　　2.插入域（插入->文件部件->域，選擇"MergeField"）

　　　　

 　　　　

　　五.實現程式碼

　　　　1.獲取文件

            Aspose.Words.Document doc = new Aspose.Words.Document(filePath);
            Aspose.Words.DocumentBuilder builder = new Aspose.Words.DocumentBuilder(doc);

　　　　2.利用word模板填充資料

  　　　　 List<string> filedsValueList = new List<string>();
　　　　　 string[] filedsName =doc.MailMerge.GetFieldNames();//獲取文件中所有的域
            for (int i = 0; i < filedsName.Length; i++)
            {              
                if (dataTable.Columns.Contains(filedsName[i]))
                {
                    filedsValueList.Add(dataTable.Rows[0][filedsName[i]].ToString());

                }
                else
                {
                    filedsValueList.Add("");
                }
            }
　　　　　　　//核心程式碼其實就是這一句，上面的都是組織資料來源
　　　　　　　//引數是兩個陣列，第一個陣列是文件中所有”域“的名稱，第二個是所對應域的值
            doc.MailMerge.Execute(filedsName, filedsValueList.ToArray());

　　　　3.插入圖片

　　　　插入圖片並不需要特殊的程式碼，而是需要對Word模板中的域做特殊設定，設定的方式為：

　　　　

　　　　在彈出來的對話方塊中，把”域“名稱的前面加上"Image:",如下圖所示：

　　　　

 　　　　設定好之後，只需要將該域的值設定為圖片的路徑，即可在文件中展示圖片，如果需要在程式碼中控制圖片的大小，需要給文件繫結圖片處理的回撥事件，程式碼如下：

doc.MailMerge.FieldMergingCallback = new HandleMerFieldInsert();

　　　　4.設定圖片尺寸

　　　　在Asponse直接提供的方法中，沒有修改圖片尺寸的方法，但是可以重寫Asponse的IFieldMergingCallback類，用於設定圖片大小　　　　

 class HandleMerFieldInsert : IFieldMergingCallback
    {
        //文字處理
        void IFieldMergingCallback.FieldMerging(FieldMergingArgs e)
        {

        }
        //圖片處理
        void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
        {
            Document doc = args.Document;
            DocumentBuilder builder = new DocumentBuilder(doc);
            builder.MoveToMergeField(args.FieldName);

             Shape shapeImage = builder.InsertImage(args.FieldValue.ToString());
                   //設定x,y座標和高寬.
                    shapeImage .Left = 0;
                    shapeImage .Top = 0;
                    shapeImage .Width = 50;
                    shapeImage .Height = 25;                                        
        }

    }

　　　　5.填充表格

　　　　填充表格資料，需要在模板中先設定表格繫結資料的起始位置，然後在每一列中設定資料來源中的列名稱，具體步驟如下圖：

　　　　

　　　　表格資料來源的起始標記為”TableStart“，結束標記為"TableEnd",設定好表格資料來源的起始與結束標記之後，再在每一列中單獨設定每一列需要繫結的欄位名稱即可，設定好的資料來源如下圖所示：

　　　　

　　　　通過Alt+F9可以看到設定好的各種域的程式碼，如下圖所示：

　　　　

　　　　設定好表格的各個域之後，通過如下程式碼完成對資料來源的填充：

dt.TableName = "UserInfo";//這裡的表格名稱必須和模板中表格的起始與結束源名稱相同
doc.MailMerge.ExecuteWithRegions(dt);

　　　　6.刪除表格及對應的佔位符

 　　　　使用Asponse進行刪除的操作相對比較複雜，現有的業務是需要刪除模板中的某一個表格，但有個問題就是，在刪除了該表格之後，該表格所在頁面的佔位符還在，會導致生成的文件有一個空白頁，因此在刪除類似表格，圖片這種元素時，還需要刪除對應的段落佔位符

 NodeCollection nodeCollection = doc.GetChildNodes(NodeType.Table, true);//獲取所有表格

                    foreach (Table table in nodeCollection)
                    {
                        if (table.GetText().Contains("AAAAAA") && table.GetText().Contains("BBBBBB"))//To Do：這裡通過獲取表格中的內容來判定是否為刪除的表格，應該還有更好的辦法
                        {
                            Paragraph paragraph = (Paragraph)table.PreviousSibling;
                            paragraph.Remove();//刪除段落
                            table.Remove();//刪除表格
                        }
                    }

　　　　7.儲存帶密碼的PDF　　　　

   Aspose.Words.Saving.PdfSaveOptions saveOption = new Aspose.Words.Saving.PdfSaveOptions();
            saveOption.SaveFormat = Aspose.Words.SaveFormat.Pdf;
            PdfEncryptionDetails encryptionDetails = new PdfEncryptionDetails(pdfPwd, string.Empty, PdfEncryptionAlgorithm.RC4_128);
            encryptionDetails.Permissions = PdfPermissions.AllowAll;
            saveOption.EncryptionDetails = encryptionDetails;
            doc.Save(fullfilepath + ".pdf", saveOption);

　　　　8.刪除未被賦值的“域”

doc.MailMerge.DeleteFields();

　　寫在最後

　　　　　　至此，Asponse利用模板處理資料的常規方法總結完畢，對於直接使用Asponse的方法，在Word中通過硬編碼的方式增加表格建議不到萬不得已不要使用，因為增加表格需要控制表格本身的樣式，還需要控制單元格的樣式，並且對於複雜的文件，定位表格也會增加難度。