C#组件系列——又一款Excel处理神器Spire.XLS
Posted 小哈龙
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了C#组件系列——又一款Excel处理神器Spire.XLS相关的知识，希望对你有一定的参考价值。
阅读目录
正文
前言：上篇 C#组件系列——又一款Excel处理神器Spire.XLS，你值得拥有（一） 介绍了下组件的两个功能，说不上特色，但确实能解决我们项目中的一些实际问题，这两天继续研究了下这个组件，觉得有些功能用起来还是挺方便的，这篇继续来看看Spire.XLS的一些其他功能，说不定有你需要的呢~~
本文原创地址：C#组件系列——又一款Excel处理神器Spire.XLS，你值得拥有（二） - 懒得安分 - 博客园
一、基础入门
1、新建Workbook
Spire.XLS提供了多种方式创建Workbook对象
1.1、新建空的Workbook
//新建Workbook
Workbook workbook = new Workbook();
//得到第一个Sheet页
Worksheet sheet = workbook.Worksheets[0];
//给A2这个单元格设置值
sheet.Range["A2"].Text = "你好,Jim" ;
//保存到物理路径
var strFullName = @"D:\\Data\\Upload\\" + "Export" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xlsx";
workbook.SaveToFile(strFullName);
就这么简单生成一个Excel文件
1.2、根据物理路径生成Workbook
//新建Workbook
Workbook workbook = new Workbook();
//将当前路径下的文件内容读取到workbook对象里面
workbook.LoadFromFile(@"D:\\Data\\Upload\\Export20160926114559.xlsx");
//得到第一个Sheet页
Worksheet sheet = workbook.Worksheets[0];
//给A2这个单元格设置值
sheet.Range["C5"].Text = "你好,Jim" ;
//保存到物理路径
var strFullName = @"D:\\Data\\Upload\\" + "Export" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xlsx";
workbook.SaveToFile(strFullName,ExcelVersion.Version2010);
1.3、根据文件流生成Workbook
上篇我们演示过多次，对于Web里面的文件上传，多用此方法。
//得到当前请求的文件 var oFile = Request.Files["txt_file"]; //根据当前的文件流生成Workbook对象 Workbook book = new Workbook(); book.LoadFromStream(oFile.InputStream);
1.4、根据Excel模板生成Workbook
这种用法适用于项目需要使用Excel模板的时候，比如我们项目需要导出的每一个Excel都适用如下模板：
那么，我们每次生成Excel的时候可以根据该模板去创建Workbook
//新建Workbook Workbook workbook = new Workbook(); //根据模板生成Workbook workbook.LoadTemplateFromFile(@"D:\\Data\\Upload\\Template.xlsx");
这样得到的Excel文件将会自动套用该模板样式。
2、读写Workbook
2.1、根据单元格的名称框来读写Excel
关于Workbook的读写，上文已经提供了一种方式，形如：
sheet.Range["C5"].Text = "你好,Jim" ;
这样就能给C5单元格赋值，如果是取值，可以直接使用同样的方式。当然，除了Text字符串的内容，组件还提供了NumberValue、DateTimeValue、BooleanValue等属性，用于读写数字、时间、bool类型的值。
当然，Range除了支持基础的单元格名称框来读写值之外，它还提供了给某一个区域的文本框赋值的功能。比如
sheet.Range["C5:E6"].Value = "你好,Jim" ;
这一句表示给C5-E6这一区域的文本框统一赋值。得到结果如下：
如果需要操作当前区域的所有单元格，可以这样：
var columes = sheet.Range["C5:E6"].Columns ; foreach (var column in columes)
2.2、根据单元格的行列索引来读写Excel
除了上面的方式，组件还支持通过行列的索引去给单元格取赋值。
sheet.Range[1, 1].Text = "部门名称";
以上一句表示给第一个行第一列单元格赋值。
3、保存Workbook
关于Excel的保存，组件同样提供了多种方式。
3.1、直接保存的方式：SaveToFile()
var strFullName = @"D:\\Data\\Upload\\" + "Export" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xlsx";
workbook.SaveToFile(strFullName);
值得一提的是，SaveToFile还支持保存不同版本的Excel，来看这个重载
public void SaveToFile(string fileName, ExcelVersion version);
ExcelVersion是一个枚举类型，定义了各种不同版本的Excel：
public enum ExcelVersion
// 摘要:
// Represents excel version 2007 xlsb
Xlsb2007 = 0,
//
// 摘要:
// Represents excel version 2010 xlsb
Xlsb2010 = 1,
//
// 摘要:
// OpenOffice Spreadsheet documents
ODS = 2,
//
// 摘要:
// Represents excel version 97-2003.
Version97to2003 = 3,
//
// 摘要:
// Represents excel version 2007
Version2007 = 4,
Version2010 = 5,
//
// 摘要:
// Represents excel version 2013.
Version2013 = 6,
3.2、保存并且转换文件
上篇介绍Excel转PDF的时候，我们知道组件提供了SaveToPdf()方法直接将Excel保存成为pdf文件，用法如下：
//保存到物理路径
var strFullName = @"D:\\Data\\Upload\\" + "Export" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".pdf";
workbook.SaveToPdf(strFullName)
除了保存成为pdf之外，还支持转换成其他格式：
保存为image
var strFullName = @"D:\\Data\\Upload\\" + "Export" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".png";
var image = workbook.SaveAsImage(0, 100, 190);
image.Save(strFullName);
SaveAsImage()第一个参数表示需要生成图片的Sheet页的索引；第二、三个参数表示生成图片的X和Y的值。
保存为xml
workbook.SaveAsXml(strFullName);
保存到文件流
using (var stream = new FileStream(strFullName, FileMode.Create))
workbook.SaveToStream(stream);
二、样式
1、文本样式
设置单元格字体样式
sheet.Range["C5:E6"].Value = "aaabbbccc"; sheet.Range["C5:E6"].Style.Font.Color = Color.FromArgb(255, 125, 125);//文本颜色 sheet.Range["C5:E6"].Style.Font.IsBold = true;//字体是否加粗 sheet.Range["C5:E6"].Style.Font.IsItalic = true;//是否斜体 sheet.Range["C5:E6"].Style.Font.Underline = FontUnderlineType.Single;//下划线 sheet.Range["C5:E6"].Style.Font.IsSuperscript = true;//是否呈现为下标 sheet.Range["C5:E6"].Style.Font.FontName = "华文彩云";//字体名称 sheet.Range["C5:E6"].Style.Font.Size = 30;//字体大小
得到结果
2、单元格样式
关于单元格样式设置
sheet.Range["C5:E6"].Style.HorizontalAlignment = HorizontalAlignType.Center;//水平对齐 sheet.Range["C5:E6"].Style.VerticalAlignment = VerticalAlignType.Center;//垂直对齐 sheet.Range["C5:E6"].ColumnWidth = 100;//单元格的宽度 sheet.Range["C5:E6"].RowHeight = 30;//行高 sheet.Range["C5:E6"].Style.Borders[BordersLineType.EdgeLeft].LineStyle = LineStyleType.Thin;//边框 sheet.Range["C5:E6"].Style.Borders[BordersLineType.EdgeRight].LineStyle = LineStyleType.Thin; sheet.Range["C5:E6"].Style.Borders[BordersLineType.EdgeTop].LineStyle = LineStyleType.Thin; sheet.Range["C5:E6"].Style.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Thin;
3、表格样式
下面来一个奇偶行的样式：
SheetStyle()
效果如下：
4、富文本编辑框
除了上面的一些简单样式外，组件还提供了富文本的编辑方式
ExcelFont fontBold = book.CreateFont(); fontBold.IsBold = true; ExcelFont fontUnderline = book.CreateFont(); fontUnderline.Underline = FontUnderlineType.Single; ExcelFont fontColor = book.CreateFont(); fontColor.KnownColor = ExcelColors.Green; RichText richText = sheet.Range["A1"].RichText; richText.Text = "Bold and underlined and colored text"; richText.SetFont(0, 3, fontBold); richText.SetFont(9, 18, fontUnderline); richText.SetFont(24, 30, fontColor);
效果
当然，这个功能可能在一些特定的场合才会用上。
三、冻结行列
组件提供了非常方便冻结行列的功能。
1、冻结行
sheet.FreezePanes(2, 1);
得到结果
2、冻结列
sheet.FreezePanes(1, 2);
得到结果
代码释疑：这里的两个参数怎么理解，第一个参数rowIndex，第二个参数columnIndex。为什么sheet.FreezePanes(2, 1)能冻结首行？这里博主的理解是这里的参数设置的是开始滑动的行和列。也就是说FreezePanes(2,1)表示从第二行、第一列开始可以滑动，而FreezePanes(1,2)表示从第一行、第二列开始可以滑动。这样是不是会好理解一点。
四、合并单元格
关于单元格的合并，组件使用也还算方便。
var mergecolumn = sheet.Merge(sheet.Range[1, 2], sheet.Range[1, 3]); mergecolumn.VerticalAlignment = VerticalAlignType.Center; mergecolumn.HorizontalAlignment = HorizontalAlignType.Center; mergecolumn.Text = "第一个合并的单元格" ;
得到结果
五、选项过滤功能
组件提供了方便的组件过滤功能
sheet.AutoFilters.Range = sheet.Range["A1:C1"];
以上表示对A1到C1这个区域的所有文本框进行过滤。效果如下：
六、下拉框
在Excel里面，经常需要用到的一个功能就是在编辑单元格的时候使用下拉框，这样方便了一些特定项的编辑。同样，组件也为我们提供了这个功能
//下拉框 CellRange range = sheet.Range["A2:A6"]; //给E1到E10所有的单元格添加下拉选项，数据来源是A2到A6的值 sheet.Range["E1:E10"].DataValidation.DataRange = range;
效果如下：
七、显示、隐藏行列
对于行列隐藏也算是一个常用功能，方法如下
//显示、隐藏行列 sheet.HideColumn(10); sheet.HideRow(8); //sheet.ShowColumn(10); //sheet.ShowRow(7);
效果
八、搜索结果高亮
foreach (CellRange range in sheet.FindAllString("行政部", true, true))
range.Style.Color = Color.LawnGreen;
效果如下
九、总结
至此，组件的一些基础功能介绍完毕。当然，这并不是全部，只是博主选的一些觉得或许有用的功能，更多功能可以参考官网文档帮助文档 ｜ 全面丰富的在线文档，助您快速了解如何使用产品
当然，如果本文能够帮到你，还是希望园友们帮忙推荐，博主下次继续努力！
本文原创出处：懒得安分 - 博客园
以上是关于C#组件系列——又一款Excel处理神器Spire.XLS的主要内容，如果未能解决你的问题，请参考以下文章