Spire.XLS,生成Excel文件、加载Excel文件-阿里云开发者社区

开发者社区> 数据库> 正文

Spire.XLS,生成Excel文件、加载Excel文件

简介: 一、组件介绍 Spire.XLS是E-iceblue开发的一套基于企业级的专业Office文档处理的组件之一,全称Spire.Office for .NET。旗下有Spire.Doc,Spire XLS,Spire.PDF,Spire.BarCode等多款专业组件,为各种Office文档在程序处理上提供了很大的方便,官方为各种功能提供了大量的在线api,简化了使用组件的难度。

一、组件介绍

Spire.XLS是E-iceblue开发的一套基于企业级的专业Office文档处理的组件之一,全称Spire.Office for .NET。旗下有Spire.Doc,Spire XLS,Spire.PDF,Spire.BarCode等多款专业组件,为各种Office文档在程序处理上提供了很大的方便,官方为各种功能提供了大量的在线api,简化了使用组件的难度。组件使用时不需要本地Office组件的支持。Spire.Office是一款企业级组件,它提供了收费版本和免费版本两种级别,一般来说,对于个人的应用,免费版本已足够用。比如对于上文博主遇到的问题,Spire.XLS组件就提供了很好的实现机制,如果你也遇到了NPOI解决不了的问题,不妨试试这个。

“XLS”是Excel文件的后缀之一,顾名思义,Spire.XLS当然就是针对Excel表格处理的组件喽,本篇,博主将结合上文遇到的问题来看看Spire.XLS组件的强大功能。

回到顶部

二、组件安装使用

对于组件的安装,在此还是提供两种方式:

回到顶部

1、官方下载安装

下载地址。官方下载的安装包是msi结尾的,安装时需要选择支持的VS版本等信息,软件的安装就不做过多说明,有兴趣的可以下载试试。

回到顶部

2、Nuget安装

大家最喜欢的应该还是Nuget方式吧,简单,方便,并且易于管理。博主也是不太喜欢为了一个组件而去单独下载一个安装包。

Spire.XLS也提供了Nuget的方式,只需要搜索Spire,选择免费版的组件即可:

安装完成后自动引用了需要的dll

3、程序撰写

3.1、创建、加载 Excel文件

using Spire.Xls;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Data;
using Spire.Pdf;
using Spire.Xls.Converter;

namespace CommonCS
{
    public class SpireInfos : IDisposable
    {
        private LoadConfig config = new LoadConfig();
        public string ExcelFilePth { get; set; }//Excel保存路径
        public string PdfFilePth { get; set; }//Pdf保存路径
        public string wordFilePth { get; set; }//Word Doc保存路径
        public string swfFilePth { get; set; }//swf Flash文件保存路径

        public SpireInfos()
        {
            ExcelFilePth = config.configManager.getConfig("path.xls");
            PdfFilePth = config.configManager.getConfig("path.pdf");
            wordFilePth = config.configManager.getConfig("path.doc");
            swfFilePth = config.configManager.getConfig("path.swf");
        }

        #region 保存Excel文件
        /// <summary>
        /// 保存Excel文件
        /// </summary>
        /// <param name="workbook">workBook</param>
        /// <param name="FileName">文件名称</param>
        public void SavaXls(Workbook workbook,string FileName="")
        {
            if (!string.IsNullOrEmpty(FileName))
            {
                workbook.SaveToFile(ExcelFilePth + FileName + ".xlsx", ExcelVersion.Version2010);
            }
            else
            {
                workbook.SaveToFile(ExcelFilePth + DateTime.Now.ToString("yyyyMMddhhmmssfff") + ".xlsx", ExcelVersion.Version2010);
            }
        }
        #endregion 

        #region 加载Excel文件 常用于加载模板
        /// <summary>
        /// 加载已存在的Excel文件 不能加载受密码保护的文件
        /// </summary>
        /// <param name="fileName">文件名称</param>
        /// <param name="version"></param>
        public void LoadFromFile(Workbook workbook,string fileName, ExcelVersion version = ExcelVersion.Version2010,string Pth="")
        {
            if (string.IsNullOrEmpty(Pth))
            {
                workbook.LoadFromFile(config.configManager.getConfig("path.xls") + fileName + ".xlsx", version);
            }
            else
            {
                workbook.LoadFromFile(Pth + fileName + ".xlsx", version);
            }
        }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="fileName">加载有密码保护的Excel文档</param>
        /// <param name="separator">密码</param>
        public void LoadFromFile(Workbook workbook, string fileName, string separator, string Pth = "")
        {
            if (string.IsNullOrEmpty(Pth))
            {
                workbook.LoadFromFile(config.configManager.getConfig("path.xls") + fileName + ".xlsx", separator);
            }
            else
            {
                workbook.LoadFromFile(Pth + fileName + ".xlsx", separator);
            }
            
        }
        #endregion

        #region Spire.Xls 导入与导出 
        /// <summary>
        /// 读取Excel数据 并导入到数据库
        /// </summary>
        /// <param name="workbook"></param>
        /// <param name="fileName"></param>
        /// <param name="sheetIndex"></param>
        /// <param name="version"></param>
        /// <param name="Pth"></param>
        /// <returns></returns>
        public DataTable ReportToDataTable(Workbook workbook, string fileName,int sheetIndex=0, ExcelVersion version = ExcelVersion.Version2010, string Pth = "")
        {
            LoadFromFile(workbook, fileName, version, Pth);
            Worksheet sheet = workbook.Worksheets[sheetIndex];
            DataTable dt = sheet.ExportDataTable();
            return dt;

        }

        /// <summary>
        /// 读取数据库 并导入到Excel
        /// </summary>
        /// <param name="workbook"></param>
        /// <param name="dt">从数据库中获取</param>
        /// <param name="sheetIndex">索引值</param>
        public void ReportToExcel(Workbook workbook, DataTable dt, int sheetIndex = 0)
        {
            Worksheet sheet = workbook.Worksheets[sheetIndex];
            int rowscount = sheet.InsertDataTable(dt, true, 1, 1);
            SavaXls(workbook);

        }
        #endregion

        #region 将 Excel 转化为PDF 
        /// <summary>
        /// 将 Excel 转化为PDF  免费应用 会生成广告
        /// </summary>
        /// <param name="workbook"></param>
        /// <param name="ExcelfileName">加载的Excel文件名 不带扩展名</param>
        /// <param name="PdffileName">要保存的Pdf文件名 不带扩展名</param>
        /// <param name="version"></param>
        /// <param name="Pth">加载的Excel文件路径</param>
        public void ExcelToPdf(Workbook workbook, string ExcelfileName, string PdffileName, ExcelVersion version = ExcelVersion.Version2010, string Pth = "")
        {
            LoadFromFile(workbook, ExcelfileName, version, Pth);
            PdfDocument pdfDocument = new PdfDocument();
            pdfDocument.PageSettings.Orientation = PdfPageOrientation.Landscape;
            pdfDocument.PageSettings.Width = 970;
            pdfDocument.PageSettings.Height = 850;

            PdfConverter pdfConverter = new PdfConverter(workbook);
            PdfConverterSettings settings = new PdfConverterSettings();
            settings.TemplateDocument = pdfDocument;
            pdfDocument = pdfConverter.Convert(settings);
            pdfDocument.SaveToFile(PdfFilePth + PdffileName + ".pdf", Spire.Pdf.FileFormat.PDF);
        }
        #endregion

        #region xls 与 xlsx 之间的相互转化 向下兼容
        //Excel 97-2003与Excel 2007在C#中的转换

        public void XlsConvertXlsx(Workbook workbook, string OldFileName, string NewFileName="", ExcelVersion version = ExcelVersion.Version97to2003, string Pth = "")
        {
            if (string.IsNullOrEmpty(Pth))
            {
                workbook.LoadFromFile(config.configManager.getConfig("path.xls") + OldFileName + ".xls", version);
            }
            else
            {
                workbook.LoadFromFile(Pth + OldFileName + ".xls", version);
            }
            SavaXls(workbook, NewFileName);
        }

        public void XlsxConvertXls(Workbook workbook,  string OldFileName, string NewFileName="", ExcelVersion version = ExcelVersion.Version2010, string Pth = "")
        {
            LoadFromFile(workbook, OldFileName);
            if (!string.IsNullOrEmpty(NewFileName))
            {
                workbook.SaveToFile(ExcelFilePth + NewFileName + ".xlsx", ExcelVersion.Version2010);
            }
            else
            {
                workbook.SaveToFile(ExcelFilePth + DateTime.Now.ToString("yyyyMMddhhmmssfff") + ".xlsx", ExcelVersion.Version2010);
            }
        }
        #endregion

        #region Excel sheet操作
        public void RemoveAllSheet()
        {

        }
        #endregion

        #region 释放资源
        /// <summary>
        /// 释放资源
        /// </summary>
        public void Dispose(Workbook workbook)
        {
            workbook.Dispose();
        } 
        
        public void Dispose()
        {
            throw new NotImplementedException();
        }
        #endregion
    }
}

大家不要被LoadConfig迷惑,我只是把文件保存的路径放在Config文件里了,上述程序中 config.configManager.getConfig("path.xls");只是返回一个路径,例如:C://Test/ 

以上便是创建、加载Excel文件的代码,现在我们作一个简单的调用,代码如下:

public class IndexModel
    {
        Workbook workbook = new Workbook();
        SpireInfos SpireInfosModel = new SpireInfos();
        public void HelloExcel()
        {
            SpireInfosModel.SavaXls(workbook,"第一次简单测试");
        }
    }

这样就会生成一个简单的Excel文件:

现在我们右键这个Excel文件,并选择属性~详细信息选项卡,如下:

我们看到,‘第一次简单测试.xlsx’文件属性~详细信息中的标题,主题,作者等信息没有值,我们如果通过程序修改这些属性的值呢?

修改Excel属性的代码如下:

public class IndexModel
    {
        Workbook workbook = new Workbook();
        SpireInfos SpireInfosModel = new SpireInfos();
        public void HelloExcel()
        {
            workbook.DocumentProperties.Author = "Jack.Chen";            //作者
            workbook.DocumentProperties.Subject = "Excel文档属性主题";   //主题
            workbook.DocumentProperties.Title = "Excel文档属性标题";    //标题
            workbook.DocumentProperties.Company = "Excel文档所属单位";     //单位
            workbook.DocumentProperties.Comments = "Excel文档备注";  //备注
            workbook.DocumentProperties.Keywords = "Excel文档标记";   //标记
            workbook.DocumentProperties.CreatedTime = DateTime.Now; //创建时间
            workbook.DocumentProperties.Category = "Excel文档分类";//类别
            workbook.DocumentProperties.Manager = "EXcel管理员";//管理员
            workbook.DocumentProperties.LastSaveTime = DateTime.Now;//最后一次保存时间
            workbook.DocumentProperties.RevisionNumber = "V1.0";//版本修订号
            workbook.DocumentProperties.ApplicationName = "ApplicationName";//程序名称
            SpireInfosModel.SavaXls(workbook,"我是修改属性后的Excel文件");
        }
    }

执行程序,会得到如下的Excel文件:

对于保密性较高的文件,我们有必要对Excel文件进行加密,那么,我们如何实现Excel文件的加密呢?

加密Excel文件,代码如下:

    public class IndexModel
    {
        Workbook workbook = new Workbook();
        SpireInfos SpireInfosModel = new SpireInfos();
        public void HelloExcel()
        {
            //Excel 加密  如果文档加密  属性设置是无效的...
            workbook.Protect("123456");//设置Excel文档的打开密码
            SpireInfosModel.SavaXls(workbook,"我是加密的Excel文件");
        }
    }

效果图如下:

代码备注中有这么一句话:加密后,属性设置无效,大家可以吧属性设置和加密放在一起试试,在此不作实验了!

如果仅仅加密文件不能满足安全性的要求?那么我们还可以加密文档中的Sheet!如果实现加密Sheet呢?

代码如下:

    public class IndexModel
    {
        Workbook workbook = new Workbook();
        SpireInfos SpireInfosModel = new SpireInfos();
        public void HelloExcel()
        {
            //Excel 加密  如果文档加密  属性设置是无效的...
            workbook.Protect("123456");//设置Excel文档的打开密码
            //继续对Sheet加密
            Worksheet sheet = workbook.Worksheets[0];
            sheet.Range["A1"].Text = "锁定";
            sheet.Range["B1"].Text = "未锁定";
            sheet.Protect("654321", SheetProtectionType.All);//密码 654321
            SpireInfosModel.SavaXls(workbook,"我是双重加密的Excel文件");
        }
    }

 

当我们尝试编辑Excel单元格时,会出现如下提醒:

那么,我们可以按照上述提示,输入密码进行解锁,在此不作演示。

项目中的需求不仅仅是创建Excel文件,很多时候会使用加载一个已经存在的文件,特别是加载模板Excel文件。那么,如何加载已经存在的Excel文件呢?

 现在,我们选择加载我们第一次测试时生成的Excel文件,即文件:第一次简单测试.Xlsx

代码示例如下:

    public class IndexModel
    {
        Workbook workbook = new Workbook();
        SpireInfos SpireInfosModel = new SpireInfos();
        public void HelloExcel()
        {
            SpireInfosModel.LoadFromFile(workbook, "第一次简单测试");
            Worksheet sheet = workbook.Worksheets[0];
            for (int j = 1; j < 11; j++)
            {
                sheet.Range["A" + j].Text = j.ToString();
                sheet.Range["B" + j].Text = j.ToString();
            }
            SpireInfosModel.SavaXls(workbook);
        }
    }

程序中演示过程如下:加载Excel文件:第一次简单测试.Xlsx,然后操作文件单元格,分别对单元格A1~A10/B1~B10赋值。赋值完毕后,并保存为新的文件

新文件如下:

 

以上便是加载Excel文件。

在本节案例中,都是些简单的案例,以后我还会深入学习这个插件,会持续写关于本插件的使用!

注:以上程序撰写的过程中,忘记了释放资源,大家可在自己的程序中添加上,这样程序会更加完善!

参考文献:http://www.cnblogs.com/asxinyu/p/4374015.html

官网文献:https://www.e-iceblue.com/Tutorials/Spire.XLS/Spire.XLS-Program-Guide/Spire.XLS-Program-Guide-Content.html

@陈卧龙的博客

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
数据库
使用钉钉扫一扫加入圈子
+ 订阅

分享数据库前沿,解构实战干货,推动数据库技术变革

其他文章