[C#]使用Gembox.SpreadSheet向Excel写入数据及图表

2023-08-23 08:41:52

本文为原创文章、源代码为原创代码，如转载/复制，请在网页/代码处明显位置标明原文名称、作者及网址，谢谢！

开发工具：VS2017

语言：C#

DotNet版本：.Net FrameWork 4.0及以上

使用的DLL工具名称：GemBox.Spreadsheet.dll （版本：37.3.30.1185）

一、GemBox.Spreadsheet工具：

该DLL是由GemBox公司开发的基于Excel功能的开发工具，该DLL很轻量，且使用起来很方便，在这里推荐下来来使用。

下载地址：

https://pan.baidu.com/s/1slcBUqh

本文就是使用该工具进行Excel的写入操作。

二、创建Excel

为了能使用该DLL，必须在调用前写入以下代码：

SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY");

创建Excel文件如下：

ExcelFile excel = new ExcelFile();

这里仅仅只是创建一个excel，代表的是excel整个文件，而保存该文件的代码如下：

excel.Save("文件路径");

三、给Excel添加一些属性

我们可以给excel添加一些诸如文档标题、作者、公司及备注等内容，实现这些内容的代码如下：

excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Title, TITLE));

excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Author, "CNXY"));

excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Company, "CNXY"));

excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Comments, "By CNXY.Website: http://www.cnc6.cn"));

四、给excel默认字体

这是给整个Excel设置统一的字体，具体代码如下：

excel.DefaultFontName = "Times New Roman";

五、添加一个Sheet表格

要知道，Excel是由Sheet表格构成的，因此添加Sheet表格的代码如下：

ExcelWorksheet sheet = excel.Worksheets.Add("表格名称");

以上，已经在excel上添加了一个名为“表格名称”的数据表格。

六、给Sheet添加密码保护

有时候，为了保护自己的Excel不被篡改，需要设置一下Sheet的密码，具体代码如下：

sheet.ProtectionSettings.SetPassword("cnxy");

sheet.Protected = true;

七、让网格线不可见

默认情况下，Sheet的网格线是可见的，有时候，我们可以设置网格线不可见，具体代码如下：

sheet.ViewOptions.ShowGridLines = false;

八、写入单元格

访问单元格的方式有三种，三种分别如下：

sheet.Cells["A1"]

sheet.Cells[,]

sheet.Rows[].Cells[]

以上三种方法都可以访问单元格，但如下写入单元格呢，其实方法很简单，如下：

sheet.Cells["A1"].Value= 内容

以上没有加双引号的原因是：内容不一定是字符串，有可能是数字、日期等。

九、单元格样式设置

单元格设置需要使用CellStyle对象，其代码如下：

CellStyle style = new CellStyle();

//设置水平对齐模式

style.HorizontalAlignment = HorizontalAlignmentStyle.Center;

//设置垂直对齐模式

style.VerticalAlignment = VerticalAlignmentStyle.Center;

//设置字体

style.Font.Size =  * PT; //PT=20

style.Font.Weight = ExcelFont.BoldWeight;

style.Font.Color = Color.Blue;

sheet.Cells["A1"].Style = style;

填充方式如下：

sheet.Cells[,].Style.FillPattern.PatternStyle = FillPatternStyle.Solid;          
sheet.Rows[].Cells[].Style.FillPattern.PatternForegroundColor = Color.Gainsboro;

设置边框如下：

style.Borders.SetBorders(MultipleBorders.Outside, Color.Black, LineStyle.Thin);

十、合并单元格

合并单元格需使用CellRange对象，我们可以从sheet.Cells.GetSubrange或GetSubrangeAbsolute获得，代码如下：

CellRange range = sheet.Cells.GetSubrange("B2", "J3");

range.Value = "Chart";

range.Merged = true;

sheet.Cells.GetSubrangeAbsolute(, , , ).Merged = true;

十一、创建Chart图表对象

使用的是LineChart对象，代码如下：

LineChart chart =(LineChart)sheet.Charts.Add(ChartType.Line,"B4","J22");

以上意思是从B4到J22创建一个LineChart对象。

设置图表标题不可见，代码如下：

chart.Title.IsVisible = false;

设置X轴与Y轴的标题可见，代码如下：

chart.Axes.Horizontal.Title.Text = "Time";

chart.Axes.Vertical.Title.Text = "Voltage";

十二、给Y轴设置属性

主要使用了chart.Axes.VerticalValue返回的ValueAxis对象，代码如下：

ValueAxis axisY =  chart.Axes.VerticalValue;

//Y轴最大刻度与最小刻度

axisY.Minimum = -;

axisY.Maximum = ;

//Y轴主要与次要单位大小

axisY.MajorUnit = ;

axisY.MinorUnit = ;

//Y轴主要与次要网格是否可见

axisY.MajorGridlines.IsVisible = true;

axisY.MinorGridlines.IsVisible = true;

//Y轴刻度线类型

axisY.MajorTickMarkType = TickMarkType.Cross;

axisY.MinorTickMarkType = TickMarkType.Inside;

十三、附上完整的源代码

using GemBox.Spreadsheet;

using GemBox.Spreadsheet.Charts;

using System;

using System.Collections.Generic;

using System.Diagnostics;

using System.Drawing;

namespace SpreadSheetChartDemo

{

    class Program

    {

        const int PT = ;

        const int LENGTH = ;

        const string TIMESNEWROMAN = "Times New Roman";

        const string TITLE = "Spread Sheet Chart Demo";

        static void Main(string[] args)

        {

            SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY");

            ExcelFile excel = new ExcelFile();

            //Excel默认字体

            excel.DefaultFontName = TIMESNEWROMAN;

            //Excel文档属性设置

            excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Title, TITLE));

            excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Author, "CNXY"));

            excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Company, "CNXY"));

            excel.DocumentProperties.BuiltIn.Add(new KeyValuePair<BuiltInDocumentProperties, string>(BuiltInDocumentProperties.Comments, "By CNXY.Website: http://www.cnc6.cn"));

            //新建一个Sheet表格

            ExcelWorksheet sheet = excel.Worksheets.Add(TITLE);

            //设置表格保护

            sheet.ProtectionSettings.SetPassword("cnxy");

            sheet.Protected = true;

            //设置网格线不可见

            sheet.ViewOptions.ShowGridLines = false;

            //定义一个B2-G3的单元格范围

            CellRange range = sheet.Cells.GetSubrange("B2", "J3");

            range.Value = "Chart";

            range.Merged = true;

            //定义一个单元格样式

            CellStyle style = new CellStyle();

            //设置边框

            style.Borders.SetBorders(MultipleBorders.Outside, Color.Black, LineStyle.Thin);

            //设置水平对齐模式

            style.HorizontalAlignment = HorizontalAlignmentStyle.Center;

            //设置垂直对齐模式

            style.VerticalAlignment = VerticalAlignmentStyle.Center;

            //设置字体

            style.Font.Size =  * PT;

            style.Font.Weight = ExcelFont.BoldWeight;

            style.Font.Color = Color.Blue;

            range.Style = style;

            //增加Chart

            LineChart chart = (LineChart)sheet.Charts.Add(ChartType.Line,"B4","J22");

            chart.Title.IsVisible = false;

            chart.Axes.Horizontal.Title.Text = "Time";

            chart.Axes.Vertical.Title.Text = "Voltage";

            ValueAxis axisY =  chart.Axes.VerticalValue;

            //Y轴最大刻度与最小刻度

            axisY.Minimum = -;

            axisY.Maximum = ;

            //Y轴主要与次要单位大小

            axisY.MajorUnit = ;

            axisY.MinorUnit = ;

            //Y轴主要与次要网格是否可见

            axisY.MajorGridlines.IsVisible = true;

            axisY.MinorGridlines.IsVisible = true;

            //Y轴刻度线类型

            axisY.MajorTickMarkType = TickMarkType.Cross;

            axisY.MinorTickMarkType = TickMarkType.Inside;

            Random random = new Random();

            double[] data = new double[LENGTH];

            for (int i=;i< LENGTH; i++)

            {

               if( random.Next(,) > )

                    data[i] = random.NextDouble() * ;

               else

                    data[i] = -random.NextDouble() * ;

            }

            chart.Series.Add("Random", data);

            //尾部信息

            range = sheet.Cells.GetSubrange("B23", "J24");

            range.Value = $"Write Time:{DateTime.Now:yyyy-MM-dd HH:mm:ss} By CNXY";

            range.Merged = true;

            //B25(三种单元格模式)

            sheet.Cells["B25"].Value = "http://www.cnc6.cn";

            sheet.Cells[,].Style.FillPattern.PatternStyle = FillPatternStyle.Solid;

            sheet.Rows[].Cells[].Style.FillPattern.PatternForegroundColor = Color.Gainsboro;

            //B25,J25

            sheet.Cells.GetSubrangeAbsolute(, , , ).Merged = true;

            string filePath = $@"{Environment.CurrentDirectory}\SheetChart.xlsx";

            try

            {

                excel.Save(filePath);

                Process.Start(filePath);

                Console.WriteLine("Write successfully");

            }

            catch(Exception ex)

            {

                Console.WriteLine(ex);

            }

            Console.Write("Press any key to continue.");

            Console.ReadKey();

        }

    }

}

十四、生成的Excel

演示的Excel下载地址：

https://pan.baidu.com/s/1slDPAED

十五、生成的exe

下载地址如下：

https://pan.baidu.com/s/1nvefYvJ

运行结果如下：

码农公寓

相关文章