C#组件系列——又一款Excel处理神器Spire.XLS，你值得拥有（二）

2023-01-25 20:27:06

前言：上篇 C#组件系列——又一款Excel处理神器Spire.XLS，你值得拥有介绍了下组件的两个功能，说不上特色，但确实能解决我们项目中的一些实际问题，这两天继续研究了下这个组件，觉得有些功能用起来还是挺方便的，这篇继续来看看Spire.XLS的一些其他功能，说不定有你需要的呢~~

本文原创地址：http://www.cnblogs.com/landeanfen/p/5906077.html

一、基础入门

1、新建Workbook

Spire.XLS提供了多种方式创建Workbook对象

1.1、新建空的Workbook

//新建Workbook

Workbook workbook = new Workbook();

//得到第一个Sheet页

Worksheet sheet = workbook.Worksheets[];

//给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[];

//给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].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 = ,

        //

        // 摘要:

        //     Represents excel version 2010 xlsb

        Xlsb2010 = ,

        //

        // 摘要:

        //     OpenOffice Spreadsheet documents

        ODS = ,

        //

        // 摘要:

        //     Represents excel version 97-2003.

        Version97to2003 = ,

        //

        // 摘要:

        //     Represents excel version 2007

        Version2007 = ,

        Version2010 = ,

        //

        // 摘要:

        //     Represents excel version 2013.

        Version2013 = ,

    }

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(, , );

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(, , );//文本颜色

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 = ;//字体大小

得到结果

2、单元格样式

关于单元格样式设置

sheet.Range["C5:E6"].Style.HorizontalAlignment = HorizontalAlignType.Center;//水平对齐

sheet.Range["C5:E6"].Style.VerticalAlignment = VerticalAlignType.Center;//垂直对齐

sheet.Range["C5:E6"].ColumnWidth = ;//单元格的宽度

sheet.Range["C5:E6"].RowHeight = ;//行高

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、表格样式

下面来一个奇偶行的样式：

public static void sheetStyle(Workbook book, Worksheet sheet)

        {

            CellStyle oddStyle = book.Styles.Add("oddStyle");

            oddStyle.Borders[BordersLineType.EdgeLeft].LineStyle = LineStyleType.Thin;

            oddStyle.Borders[BordersLineType.EdgeRight].LineStyle = LineStyleType.Thin;

            oddStyle.Borders[BordersLineType.EdgeTop].LineStyle = LineStyleType.Thin;

            oddStyle.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Thin;

            oddStyle.KnownColor = ExcelColors.LightGreen1;

            CellStyle evenStyle = book.Styles.Add("evenStyle");

            evenStyle.Borders[BordersLineType.EdgeLeft].LineStyle = LineStyleType.Thin;

            evenStyle.Borders[BordersLineType.EdgeRight].LineStyle = LineStyleType.Thin;

            evenStyle.Borders[BordersLineType.EdgeTop].LineStyle = LineStyleType.Thin;

            evenStyle.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Thin;

            evenStyle.KnownColor = ExcelColors.LightTurquoise;

            foreach (CellRange range in sheet.AllocatedRange.Rows)

            {

                if (range.Row %  == )

                    range.CellStyleName = evenStyle.Name;

                else

                    range.CellStyleName = oddStyle.Name;

            }

            //Sets header style

            CellStyle styleHeader = sheet.Rows[].Style;

            styleHeader.Borders[BordersLineType.EdgeLeft].LineStyle = LineStyleType.Thin;

            styleHeader.Borders[BordersLineType.EdgeRight].LineStyle = LineStyleType.Thin;

            styleHeader.Borders[BordersLineType.EdgeTop].LineStyle = LineStyleType.Thin;

            styleHeader.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Thin;

            styleHeader.VerticalAlignment = VerticalAlignType.Center;

            styleHeader.KnownColor = ExcelColors.Green;

            styleHeader.Font.KnownColor = ExcelColors.White;

            styleHeader.Font.IsBold = true;

            sheet.Columns[sheet.AllocatedRange.LastColumn - ].Style.NumberFormat = "\"$\"#,##0";

            sheet.Columns[sheet.AllocatedRange.LastColumn - ].Style.NumberFormat = "\"$\"#,##0";

            sheet.AllocatedRange.AutoFitColumns();

            sheet.AllocatedRange.AutoFitRows();

            sheet.Rows[].RowHeight = ;

        }

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(, , fontBold);

richText.SetFont(, , fontUnderline);

richText.SetFont(, , fontColor);

效果

当然，这个功能可能在一些特定的场合才会用上。

三、冻结行列

组件提供了非常方便冻结行列的功能。

1、冻结行

sheet.FreezePanes(, 1);

得到结果

2、冻结列

sheet.FreezePanes(, );

得到结果

代码释疑：这里的两个参数怎么理解，第一个参数rowIndex，第二个参数columnIndex。为什么sheet.FreezePanes(2, 1)能冻结首行？这里博主的理解是这里的参数设置的是开始滑动的行和列。也就是说FreezePanes(2,1)表示从第二行、第一列开始可以滑动，而FreezePanes(1,2)表示从第一行、第二列开始可以滑动。这样是不是会好理解一点。

四、合并单元格

关于单元格的合并，组件使用也还算方便。

var mergecolumn = sheet.Merge(sheet.Range[, ], sheet.Range[, ]);

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();

sheet.HideRow();

//sheet.ShowColumn(10);

//sheet.ShowRow(7);

效果

八、搜索结果高亮

foreach (CellRange range in sheet.FindAllString("行政部", true, true))

{

       range.Style.Color = Color.LawnGreen;

}

效果如下

九、总结

至此，组件的一些基础功能介绍完毕。当然，这并不是全部，只是博主选的一些觉得或许有用的功能，更多功能可以参考官网文档。

当然，如果本文能够帮到你，还是希望园友们帮忙推荐，博主下次继续努力！

本文原创出处：http://www.cnblogs.com/landeanfen/

欢迎各位转载，但是未经作者本人同意，转载文章之后必须在文章页面明显位置给出作者和原文连接，否则保留追究法律责任的权利

码农公寓

一、基础入门

1、新建Workbook

1.1、新建空的Workbook

1.2、根据物理路径生成Workbook

1.3、根据文件流生成Workbook

1.4、根据Excel模板生成Workbook

2、读写Workbook

2.1、根据单元格的名称框来读写Excel

2.2、根据单元格的行列索引来读写Excel

3、保存Workbook

3.1、直接保存的方式：SaveToFile()

3.2、保存并且转换文件

二、样式

1、文本样式

2、单元格样式

3、表格样式

4、富文本编辑框

三、冻结行列

1、冻结行

2、冻结列

四、合并单元格

五、选项过滤功能

六、下拉框

七、显示、隐藏行列

八、搜索结果高亮

九、总结

相关文章