利用Aspose.Word控件实现Word文档的操作
偶然一次机会,一个项目的报表功能指定需要导出为word文档,因此寻找了很多篇文章,不过多数介绍的比较简单一点,于是也参考了官方的帮助介绍,终于满足了客户的需求。下面我由浅入深来介绍这个控件在实际业务中的使用过程吧。
1、二维表格的word操作
日常中,常见的内容输出就是二维表格的方式,表头比较固定,内容每行一条,那么在实际的使用控件我们该如何操作呢,其实这个控件这方面介绍的文章很多,参考一下就能做出来了。其实介绍这个就是要说明书签的重要性,这个在aspose.cell控件也是如此,书签除了可以用来替换内容,还可以用来标记内容输入的开始位置等等功能。
首先我们在一个空白的word文档中绘制一个表格头,然后再换行的开始插入一个标签引用,插入书签有两种方式,一种是在word(2007、2010)的【插入】-【书签】中插入制定位置的书签引用,如下所示。
一种是在word的自定义快速访问工具栏上添加其他命令,如下步骤所示
前者插入的书签是没有文字或者特别的标记,但是确实存在,后者会插入一个灰色块作为占位符,如下所示,我这这个二维表格的例子里面使用后者进行测试(两者同等效果的)
这样设计好word模板后,下一步就是如何利用代码生成二维表格了。首先这里提示一下,就是我故意设置了每个表格单元格的宽度不同,所以也就要求生成的行要和头部对应,所以表格生成每行之前,肯定要获得对应列的样式属性的,否则就会对应不上了。下面看代码。
try
{
aspose.words.document doc = new aspose.words.document(templatefile);
aspose.words.documentbuilder builder = new aspose.words.documentbuilder(doc);
datatable namelist = datatablehelper.createtable("编号,姓名,时间");
datarow row = null;
for (int i = 0; i < 50; i++)
{
row = namelist.newrow();
row["编号"] = i.tostring().padleft(4, '0');
row["姓名"] = "伍华聪 " + i.tostring();
row["时间"] = datetime.now.tostring();
namelist.rows.add(row);
}
list<double> widthlist = new list<double>();
for (int i = 0; i < namelist.columns.count; i++)
{
builder.movetocell(0, 0, i, 0); //移动单元格
double width = builder.cellformat.width;//获取单元格宽度
widthlist.add(width);
}
builder.movetobookmark("table"); //开始添加值
for (var i = 0; i < namelist.rows.count; i++)
{
for (var j = 0; j < namelist.columns.count; j++)
{
builder.insertcell();// 添加一个单元格
builder.cellformat.borders.linestyle = linestyle.single;
builder.cellformat.borders.color = system.drawing.color.black;
builder.cellformat.width = widthlist[j];
builder.cellformat.verticalmerge = aspose.words.tables.cellmerge.none;
builder.cellformat.verticalalignment = cellverticalalignment.center;//垂直居中对齐
builder.paragraphformat.alignment = paragraphalignment.center;//水平居中对齐
builder.write(namelist.rows[i][j].tostring());
}
builder.endrow();
}
doc.range.bookmarks["table"].text = ""; // 清掉标示
doc.save(savedocfile);
if (messageutil.showyesnoandtips("保存成功,是否打开文件?") == system.windows.forms.dialogresult.yes)
{
system.diagnostics.process.start(savedocfile);
}
}
catch (exception ex)
{
loghelper.error(ex);
messageutil.showerror(ex.message);
return;
}
以上代码的步骤就是
1)创建aspose.words.document 和 aspose.words.documentbuilder对象,然后生成数据的二维表格内容。
2)遍历模板表格,或者每一列的宽度,以备后用。
3)移动到表格的书签位置,然后开始录入数据,word表格的每个cell都要求制定样式和宽度,这样才能和表格头部吻合。
4)保存文件内容到新的文件里面即可。
输出的效果如下所示。
2、单元格合并的操作
常见的word文件或者excel文件中,都经常看到合并单元格的内容,因此这个部分也是非常常见的操作,必须掌握。
我们先看一个例子代码及效果。
try
{
aspose.words.document doc = new aspose.words.document(templatefile);
aspose.words.documentbuilder builder = new aspose.words.documentbuilder(doc);
builder.insertcell();
builder.cellformat.borders.linestyle = linestyle.single;
builder.cellformat.borders.color = system.drawing.color.black;
builder.cellformat.verticalmerge = cellmerge.first;
builder.write("text in merged cells.");
builder.insertcell();
builder.cellformat.borders.linestyle = linestyle.single;
builder.cellformat.borders.color = system.drawing.color.black;
builder.cellformat.verticalmerge = cellmerge.none;
builder.write("text in one cell");
builder.endrow();
builder.insertcell();
builder.cellformat.borders.linestyle = linestyle.single;
builder.cellformat.borders.color = system.drawing.color.black;
// this cell is vertically merged to the cell above and should be empty.
builder.cellformat.verticalmerge = cellmerge.previous;
builder.insertcell();
builder.cellformat.borders.linestyle = linestyle.single;
builder.cellformat.borders.color = system.drawing.color.black;
builder.cellformat.verticalmerge = cellmerge.none;
builder.write("text in another cell");
builder.endrow();
doc.save(savedocfile);
if (messageutil.showyesnoandtips("保存成功,是否打开文件?") == system.windows.forms.dialogresult.yes)
{
system.diagnostics.process.start(savedocfile);
}
}
catch (exception ex)
{
loghelper.error(ex);
messageutil.showerror(ex.message);
return;
}
他的效果如下
关于合并单元格的介绍,你还可以参考下这篇官方介绍:http://www.aspose.com/docs/display/wordsnet/working+with+merged+cells
如果上面的例子还不够明白,ok,我在介绍一个实际的例子,来说明合并单元格的操作模式。
实际文档生成如下所示:
文档的模板如下所示:
其实这个里面的“测试”内容是使用代码写入的,其实就是一行业务数据,用两行来展示,其中有些合并的单元格,这是一个实际项目的表格形式。我们注意到,每行有13个单元格,其中第一、第二、第十三列是合并列。和并列有一个特点,就是它的两个索引都有效,不过只是能使用第一个索引来对它进行操作复制,利用第二个没有用处的。
如第一个列是和并列,它应该有0、13这样的索引,第二列也是和并列,它也有1、14的索引,其他的类推。
了解这样的逻辑关系后,我们看实际操作的代码如下所示。
撰写人:伍华聪