【好文翻译】一步一步教你使用Spire.Doc转换Word文档格式

背景：

本文试图证明和审查Spire.Doc的格式转换能力。很长的一段时间里，为了操作文档，开发人员不得不在服务器上安装Office软件。首先，这是一个很糟糕的设计和实践。第二，微软从没打算把Office作为一个服务器组件，它也用来在服务器端解释和操作文档的。于是乎，产生了类似Spire.Doc这样的类库。当我们讨论这个问题时，值得一提的是 Office Open Xml. Office Open XML (也有非正式地称呼为 OOXML 或OpenXML) 是一种压缩的, 基于XML的文件格式，由微软开发，用于表现电子表格，展示图表，演示和文字处理等。在2005年11月，微软宣布作为ECMA国际主要合作伙伴，将其开发的基于XML的文件格式标准化，称之为"Office Open XML" 。Open XML的引进使office文档结构更加标准化，并且开发人员使用 Open XML SDK可以直接进行很多简单的操作，但是仍然有很多差距，如将word文档转换成其他格式，比如PDF，图像，或者HTML等。这就是Spire.Doc 来拯救开发人员的原因。

文档转换：

我将在文章的其余部分来介绍Spire.Doc可以适用的多种场景。文中展示的所有例子均可以在 Spire.Doc 的DEMO中找到，你可以很容易地下载并使用它们。我的例子是一个简单的控制台程序，当然它也支持其他平台，如web项目或者Silverlight项目等。

用他们自己的话来说，Spire.Doc 宣称："Spire.Doc for .NET 可以将word文件转换成最常见和流行的格式。"

为了开始使用Spire.Doc，你首先需要添加Spire.Doc,Spire.License 和 Spire.Pdf引用到你的项目中，这两个组件是打包在Spire.Doc中的.





你需要一个有效的 Spire.Doc授权文件才能使用这个类库，否则它将在文档中显示"评估版本"警告。设置授权非常简单，只要设置授件位置，类库就会自动完成验证等工作。还有其他的方法来加载授权文件，比如动态指定或将其加入到资源文件中。详细的文档可以参考这里。.

FileInfo licenseFile = new FileInfo(@"C:\ManasBhardwaj\license.lic");

Spire.License.LicenseProvider.SetLicenseFile(licenseFile);

为了验证基本的功能，我使用了一个word文档包含简单文字、一张图片和一个表格。如下图所示，你也可以在Demo中找到。



类库的核心当然是Document类。所以我们从创建Document对象开始，然后加载文档信息。简单得只需要三行代码，你就可以把一个相当复杂包含不同元素的Word文档转换成一个完全不同的文档，比如HTML格式文档。

//Create word document

Document document = new Document();

document.LoadFromFile(@"This is a Test Document.docx");

插入图片

//Insert image

DocPicture picture=document.Sections[0].Paragraphs[0].AppendPicture(Image.FromFile(image.png);

插入表格

addTable(document.Sections[0]);

privatevoid addTable(Section section)

{

　　//create a table with border

　　Spire.Doc.Table table = section.AddTable(true );

　　String[] header = { "Column A", "Column B", "Column C" };

　　String[][] data ={

　　newString[]{"Value 1","V 1.1","V 1.2"} ,

　　newstring[]{"Value 2","V 2.1","V 2.2"}

};

table.ResetCells(data.Length + 1, header.Length);

TableRow Frow = table.Rows[0];

Frow.IsHeader = true;

Frow.Height = 15; //unit: point, 1point = 0.3528 mm

for (int i = 0; i < header.Length; i++)

{

　　Frow.Cells[i].CellFormat.BackColor = Color.FromArgb(142, 91, 155, 213);

　　Frow.Cells[i].CellFormat.VerticalAlignment = VerticalAlignment.Middle;

　　Paragraph p = Frow.Cells[i].AddParagraph();

　　p.Format.HorizontalAlignment = Spire.Doc.Documents.HorizontalAlignment.Left;

　　TextRange txtRange = p.AppendText(header[i]);

　　txtRange.CharacterFormat.Bold = true;

}

for (int r = 0; r < data.Length; r++)

{

　　TableRow dataRow = table.Rows[r + 1];

　　dataRow.Height = 15;

　　dataRow.HeightType = TableRowHeightType.Exactly;

　　dataRow.RowFormat.BackColor = Color.Empty;

for (int c = 0; c < data[r].Length; c++)

{

if (r % 2 == 0)

　　dataRow.Cells1.CellFormat.BackColor = Color.FromArgb(137, 222, 230, 246);

　　dataRow.Cells1.CellFormat.VerticalAlignment = VerticalAlignment.Middle;

　　dataRow.Cells1.AddParagraph().AppendText(data[r]1);

}

}

}

转化成HTML文档

//将文件转化成HTML文档

document.SaveToFile("Test.html", FileFormat.Html);

所以，现在我们已经有了准备转换的文档可以使用。我们来看看在这背后发生了什么。你可以看到产生了一个新的HTML文档，还有额外的文件和文件夹。这些文件和文件夹都不过是用于保留原word文档中存在的额外信息用的。在这一范例中，文件夹中包含了原有文档中我们添加的那张测试图片，而样式表中所包含了表格的样式定义。所以，这个转换不仅转换了数据，还尽力保证了类似样式这些额外信息的完整性。



样式表看起来是这样的：



只是一个简单参数的不同，就可以让你可以把文档转换成另一种格式，比如下述的PDF。最另我满意的是，所有这些都是基于一个框架，我们可以将文档转换成不同的格式而不需要额外的样式和配置定义。而且请注意，所有这些都是在内存中完成的，因此你不需要额外的系统权限。我记得以前在一个项目中当我们想转换时，为了导出PDF我们不得不将数据从一个组件传到另一个，而且还不能在不同的文档格式中保持相同的布局。

转成PDF

//把文件转化成PDF

document.SaveToFile("Test.Pdf", FileFormat.PDF);

只需很少的代码你就得到了下面的PDF文档。因为我使用的是试用版本所以有授权警告。当你使用正式版时，就没有警告了。



转换成XML

在FileFormat 类中显示它最多支持24种文件格式。我自己最喜欢XML格式。它具有很好的扩展性，你可以在文档中对数据做很多处理。比如，你可以使用word文档创建一个来源于原始文件的XML文档。

//Convert the file to Xml

document.SaveToFile("Test.Xml", FileFormat.Xml);



转成图片

那么转成图片呢？Spire.Doc支持把文档直接转换成图片，所有.net框架支持的图片格式都可以。

//保存成图片

Image image = document.SaveToImages(0, ImageType.Metafile);

image.Save("Test.tif", System.Drawing.Imaging.ImageFormat.Tiff);

总结

在转换word文档到其他任何格式文件方面，Spire.Doc 是一个功能非常强大，而且易于使用的产品。如果你也使用其报表功能，那就更好了。和其他第三方厂商一样，通常有很多方法完成同一件事，但是你需要权衡购买或再使用的成本和产品带来的方便。

从许可和定价上来说，与市场上其他类似产品相比，它并不是很贵。所以，在我看来这是一个非常划算的花销。