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

时间:2022-05-03 04:27:53

背景:

年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转换Word文档格式

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

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

Spire.License.LicenseProvider.SetLicenseFile(licenseFile);

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

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

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

//Create word document

Document document = new Document();

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

插入图片

//Insert image

].AppendPicture(Image.FromFile(image.png);

插入表格

]);

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"}

};

, header.Length);

];

Frow.IsHeader = true;

; //unit: point, 1point = 0.3528 mm

; i < header.Length; i++)

{

);

  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;

}

; r < data.Length; r++)

{

];

;

  dataRow.HeightType = TableRowHeightType.Exactly;

  dataRow.RowFormat.BackColor = Color.Empty;

; c < data[r].Length; c++)

{

)

);

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

);

}

}

}

转化成HTML文档

//将文件转化成HTML文档

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

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

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

样式表看起来是这样的:

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

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

转成PDF

//把文件转化成PDF

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

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

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

转换成XML

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

//Convert the file to Xml

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

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

转成图片

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

//保存成图片

, ImageType.Metafile);

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

总结

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

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