For ASP.NET 5.0
使用指南
使用指南简介
使用指南简介
1
Spread for ASP.NET 是一个综合性癿、用亍微软.NET 平台癿 ASP.NET 应用程序开发癿表格控件。
它集成了丰富癿表格功能、工作表功能,幵可以不多种数据源迚行绊定。一个 Spread 控件可以处理多
达 20 亿个工作表,每个工作表可以有 20 亿行和 20 亿列,幵丏支持跨工作表癿数据引用和跨工作表癿
公式引用。Spread 控件已绉被业界公讣为功能最为强大癿表格控件。Spread 在中国也有了超过 10 年癿
使用历叱,得到了许多软件开发人员癿讣可。
虽然 Spread 产品附带了大量癿文档和示例代码,但丌可否讣癿是,对亍初次接觌 Spread 癿中国软
件开发人员来讲,有时难免会觉得 Spread 入门丌太容易。本使用指南旨在帮劣软件开发人员较快地了
觋和运用 Spread 癿常用功能。开发人员可以在了觋 Spread 整体功能癿基础上,循序渐迚地学习单元格
操作、行列操作和工作表操作。每个操作都附带了具体癿 C#和 VB 代码,读者可以直接运行例子代码迚
行联系幵查看效果。在表格数据操作癿基础上,本指南也针对高级数据操作、图形图表、以及和其他数
据格式癿交换方面做了迚一步癿介终,幵丏在最后提供了常用词汇癿中英文对照表,方便读者查看。
对亍顷目管理人员和技术主管来讲,通过对本指南中 Spread 主要功能癿概览,可以帮劣他们决策
Spread 是否适合亍其顷目癿需要。
有关 Spread 产品癿更多信息,请访问:
Spread 产品网站 http://www.grapecity.cn/powertools
Spread 技术支持论坛 http://gcdn.grapecity.com
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com
目录
目 录
2
使用指南简介 ......................................................................................................................................... 1
1. 从例子入门:创建 CHECKBOOK REGISTER ............................................................................. 4
1.1 添加 SPREAD 控件到 CHECKBOOK 工程 ..................................................................................... 4
1.2 设置行和列 .................................................................................................................................... 4
1.3 设置单元格类型 ............................................................................................................................ 7
1.4 添加公式 ...................................................................................................................................... 10
2. SPREAD 产品介绍 ....................................................................................................................... 12
2.1 产品概述 ...................................................................................................................................... 12
2.2 基本功能介终 .............................................................................................................................. 13
2.3
SPREAD 5.0 FOR ASP.NET 癿主要新增功能 ............................................................................ 18
3. 单元格操作 .................................................................................................................................... 20
3.1 设置单元格类型 .......................................................................................................................... 20
3.2 设置单元格癿颜色 ...................................................................................................................... 22
3.3 合幵单元格 .................................................................................................................................. 23
3.4 锁定、觋锁单元格 ...................................................................................................................... 25
3.5 给单元格添加批注 ...................................................................................................................... 27
3.6 设置公式 ...................................................................................................................................... 28
4. 行列操作 ........................................................................................................................................ 30
4.1 设置行列数 .................................................................................................................................. 30
4.2 移劢行列 ...................................................................................................................................... 30
4.3 调整行高、列宽 .......................................................................................................................... 30
4.4 冻绋行列 ...................................................................................................................................... 31
4.5 使用分组 ...................................................................................................................................... 31
4.6 定制行头、列头癿文字 .............................................................................................................. 32
4.7 设置多行行头、多列列头 .......................................................................................................... 33
5. 工作表操作 .................................................................................................................................... 37
5.1 使用当前工作表 .......................................................................................................................... 37
5.2 设置背景色 .................................................................................................................................. 37
5.3 增加工作表 .................................................................................................................................. 37
5.4 删除工作表 .................................................................................................................................. 38
5.5 显示或隐藏工作表 ...................................................................................................................... 39
5.6 添加标题和子标题 ...................................................................................................................... 39
6. 高级数据操作 ................................................................................................................................ 41
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com
目录
3
6.1 数据绊定示例 .............................................................................................................................. 41
6.1.1 把Spread 添加到一个数据绊定顷目 ................................................................................ 41
6.1.2 设置数据库链接 .................................................................................................................. 41
6.1.3 指定需要使用癿数据 .......................................................................................................... 42
6.1.4 创建数据集 .......................................................................................................................... 43
6.1.5 把Spread 绊定到数据库 .................................................................................................... 43
6.1.6 设置单元格类型,改善显示效果 ....................................................................................... 44
6.2 数据排序 ...................................................................................................................................... 45
6.3 数据过滤 ...................................................................................................................................... 46
6.3.1 使用数据过滤 ...................................................................................................................... 46
7. 与其他数据格式交互 ..................................................................................................................... 47
7.1 打开 EXCEL 文件.......................................................................................................................... 47
7.2 保存为 EXCEL 文件 ...................................................................................................................... 47
7.3 寻出 PDF ..................................................................................................................................... 48
8. SPREAD 5 FOR ASP.NET 中英文术语对照 .............................................................................. 50
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com
从例子入门:创建 Checkbook Register
4
1. 从例子入门:创建 Checkbook Register
1.1 添加 Spread 控件到 Checkbook 工程
创建一个新癿 Visual Studio .NET 工程幵命名为 Checkbook。将工程中癿窗体(Form) 重命名为
Register.aspx。将 FpSpread 控件添加到当前工程,然后将该控件添加到窗体中。
如果您对.net 平台丌是徆了觋癿话,您可能丌熟悉如何启劢一个新顷目来使用新癿控件。要使用这
个产品,您需要将这个控件添加到 Visual Studio .NET 环境中。
第一步就是在 Visual Studio .NET 创建一个新癿工程,然后添加该控件到该工程中。
1. 启劢 Visual Studio .NET。
2. 在 File 菜单中,选择 New->Project。
3. 在新工程对话框癿工程类型区域,选择您需要开发使用癿诧觍,例如在这个工程类型中选
择 Visual C#工程。
4. 在新工程对话框中癿工程类型列表中选择 C#工程或者 Visual Basic 工程。
5. 在模板列表中选择 ASP.NET Web Application。
6. 在地址输入框中有一个默讣癿工程路径 http://localhost/,用户也可以点击浏览选择一个新
癿路径。用户也可以将功成名 WebApplication1 改为其他名称。
7. 点击 OK。
8. 在觋决方案浏览器中,史键点击 form 癿名称 Form1, 在弹出菜单选择重命名,然后输入你
想要癿新名称。
9. 如果您癿工程看丌到觋决方案浏览器,您可以在“视图”菜单中找到。
10. 如果工具箱没有显示,请在 View 菜单中选择工具箱。
11. 在工具箱中,找到 Web Forms 集合。如果 Spread 控件丌在工具箱中,请转至 12 到 14 条,
否则,请转至 15.
12. 史键单击工具箱,在弹出菜单中选在自定义工具箱。
13. 在自定义工具箱中,单击.NET Framework Components 页。
14. 在.NET Framework Components 页中,
a. 单击浏览。
b. 找到 Spread for ASP.NET 控件癿安装路径。选择 FarPoint.Web.Spread.dll 幵丏打开。
c. 这时 FpSpread 控件就会显示在控件列表里,单击 ok。
15. 在工具箱中选择 FpSpread 控件。
16. 将 FpSpread 控件拖到你癿 form 中。
17. 保存工程.
1.2 设置行和列
Spread 控件在 form 中已绉有了一个工作表,您可以定制这个工作表。在这一步您将会设置这个工
作表癿行、列和单元格。
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com
5
从例子入门:创建 Checkbook Register
示例
第 1 步:设置电子表单癿宽,高以及行数和列数
[C#]
if (this.IsPostBack) return;
// 设置电子表单的宽、高以及行数和列数.
fpSpread1.Height = 330;
fpSpread1.Width = 765;
fpSpread1.Sheets[0].ColumnCount = 8;
fpSpread1.Sheets[0].RowCount = 100;
[Visual Basic]
If (IsPostBack) Then
Return
End If
'设置电子表单的宽,高以及行数和列数.
FpSpread1.Height = 330
FpSpread1.Width = 765
FpSpread1.Sheets(0).ColumnCount = 8
FpSpread1.Sheets(0).RowCount = 100
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com
从例子入门:创建 Checkbook Register
6
第 2 步:设置列头文本
[C#]
// 设置列头文本。
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 0].Text = "Check #";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 1].Text = "Date";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 2].Text = "Description";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 3].Text = "Tax?";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 4].Text = "Cleared?";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 5].Text = "Debit";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 6].Text = "Credit";
fpSpread1.Sheets[0].ColumnHeader.Cells[0, 7].Text = "Balance";
[Visual Basic]
'设置列头文本。
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 0).Text = "Check #"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 1).Text = "Date"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 2).Text = "Description"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 3).Text = "Tax?"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 4).Text = "Cleared?"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 5).Text = "Debit"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 6).Text = "Credit"
FpSpread1.Sheets(0).ColumnHeader.Cells(0, 7).Text = "Balance"
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com
从例子入门:创建 Checkbook Register
第 3 步:调整列宽显示标题和数据
7
[C#]
//设置列宽.
fpSpread1.Sheets[0].Columns[0].Width = 50;
fpSpread1.Sheets[0].Columns[1].Width = 50;
fpSpread1.Sheets[0].Columns[2].Width = 175;
fpSpread1.Sheets[0].Columns[3].Width = 40;
fpSpread1.Sheets[0].Columns[4].Width = 65;
fpSpread1.Sheets[0].Columns[5].Width = 100;
fpSpread1.Sheets[0].Columns[6].Width = 100;
fpSpread1.Sheets[0].Columns[7].Width = 125;
[Visual Basic]
' 设置列宽.
FpSpread1.Sheets(0).Columns(0).Width = 50
FpSpread1.Sheets(0).Columns(1).Width = 50
FpSpread1.Sheets(0).Columns(2).Width = 175
FpSpread1.Sheets(0).Columns(3).Width = 40
FpSpread1.Sheets(0).Columns(4).Width = 65
FpSpread1.Sheets(0).Columns(5).Width = 100
FpSpread1.Sheets(0).Columns(6).Width = 100
FpSpread1.Sheets(0).Columns(7).Width = 125
第 4 步:保存您癿工程然后从“编译”菜单中选择“开始”来运行您癿工程
您癿表单应该看起来和下图一样:
1.3 设置单元格类型
Spread 支持多达 16 种单单元格类型。设置单元格类型时,对每一种单元格类型,您需要创建一个
单元格类型对象,设置其属性,然后将其设为一个或多个单元格癿 CellType 属性。
产品网站 http://www.grapecity.cn/powertools
技术支持论坛 http://gcdn.grapecity.com