Aspose.Pdf合并PDF文件

使用Aspose.Pdf类库，有很多种方法可以合并PDF文件，这里简单介绍小生见到的几种：

• Doucment.Pages.Add
• PdfFileEditor.Append
• PdfFileEditor.Concatenate

---

Doucment.Pages.Add

要合并几个PDF文件，实际上就是把文档里的页合并到同一个文件里面，
所以可以打开PDF文件，简单的把其他文件的页面添加即可

Doucment pdfdoc1 = new Doucment("input.pdf");
Doucment pdfdoc2 = new Doucment("input.pdf");

pdfdoc1.Pages.Add(pdfdoc2.Pages);

pdfdoc1.Save("output.pdf");

---

PdfFileEditor.Append

基本思路和上面是一样的，讲一个文件的页面添加到另一个文件末尾，
但是调用这个方法需要指定输入文件，要添加的文件，以及要添加的页数范围和输出文件

PdfFileEditor.Append(input, ports, startpage, endpage, output)

• input 输入文件，可以是String类型的文件路径，也可以是Stream类型的文件数据流

• ports 要添加的文件，可以是一个文件，也可以是一个数组，类型同input一样可以是String也可以是Stream

• startpage和endpage 要添加的页数范围，这个范围是指所有ports放在一起的页数范围
  例如：ports有三个文件，分别有3页，4页，5页，指定startpage=1和endpage=4，
  则会添加第一个文件的所有页面和第二个文件的第一页

• output 输出文件，同input，可以是String和Stream类型，在ports维数组时也可以是HttpResponse类型

PdfFileEditor pdfeditor = new PdfFileEditor();

// 将input2.pdf的第一页添加到input1.pdf末尾并输出output.pdf
pdfeditor.Append("input1.pdf", "input2.pdf", 1, 1, "output.pdf");

FileStream input1 = new FileStream("input1.pdf", FileMode.Open);
FileStream input2 = new FileStream("input2.pdf", FileMode.Open);
FileStream output = new FileStream("output.pdf", FileMode.Open);
pdfeditor.Append(input1, input2, 1, 1, output);

// 将input2.pdf、input3.pdf的前6页添加到input1.pdf末尾并输出output.pdf
String[] ports = new String[]{"input2.pdf", "input3.pdf"};
pdfeditor.Append("input1.pdf", ports, 1, 6, "output.pdf");

FileStream input1 = new FileStream("input1.pdf", FileMode.Open);
FileStream[] ports = new FileStream[]{
    new FileStream("input2.pdf", FileMode.Open),
    new FileStream("input3.pdf", FileMode.Open)
};
FileStream output = new FileStream("output.pdf", FileMode.Open);
pdfeditor.Append(input1, ports, 1, 6, output);

// 将结果输出到HTTP响应
pdfeditor.Append(input1, ports, 1, 6, HttpContext.Current.Response);

---

PdfFileEditor.Concatenate

Concatenate方法与Append的调用方式类似，也支持一个或多个路径String或数据流Stream输入，
输出到一个路径String、数据流Stream或HTTP请求响应HttpResponse，
但是并不支持合并页数的指定，会将输入文件一个接着一个的合并，其重载列表如下

// 将两个文件合并成一个输出
Concatenate(Stream, Stream, Stream)
Concatenate(String, String, String)

// 多个文件合并成一个
Concatenate(Stream[], Stream)
Concatenate(Stream[], HttpResponse)
Concatenate(String[], String)
Concatenate(String[], HttpResponse)
Concatenate(Document[], Document)

// 前方高能
Concatenate(Stream, Stream, Stream, Stream)
Concatenate(String, String, String, String)

其中四个参数的重载方法，允许将两个文件交叉的合并成一个文件并用指定页填充空白页，
举例来说，加入input1.pdf有6页p1, p2, p3, p4, p5, p6，input2.pdf有3页p1', p2', p3'，
再加上空白页blank.pdf，则输出为p1, p1', p2, p2', p3, p3', p4, blank, p5, blank, p6，
注意这里因为没有p4', p5'所以使用blank页来代替

PdfFileEditor pdfeditor = new PdfFileEditor();
pdfeditor.Concatenate("input1.pdf", "input2.pdf", "blank.pdf", "output.pdf");

另外，因为小生的业务需求，需要在pdf合成完毕之后删除源文件，
所以就在执行完Concatenate方法后直接调用File.Delete方法删除文件，
但是却报错了，在看了API文档之后才了解到，需要设置
PdfFileEditor.CloseConcatenateStreams = true;，
在合成完毕之后，关闭Stream。

参考链接
Concatenate PDF Files
Append PDF files
Concatenate PDF Files with Blank PDF Using File Paths (Facades)
PdfFileEditor Class