ExcelManager--基于.Net的Excel读写管理类库（一）

相关使用手册

ExcelManager（V1.1）手册

---

修订历史记录

日期	版本	说明	作者
2006-5-25	1.0	初稿	林付国
2006-5-27	1.1	增加约束及注意事项	林付国

目录

一、目标... 2

二、功能... 2

三、约束... 2

四、注意事项... 2

六、适用范围... 3

五、性能测试... 3

六、使用方法... 3

七、版权... 6

一、目标

ExcelManager的目标，便是设计一个基于.Net的通用的Excel读写管理类库，以简化基于.Net平台的Excel应用开发。

二、功能

       目前，ExcelManager主要关注以下几个方面：

1.      文件读取

2.      文件某单元格读取

3.      文件写入

4.      包括样式的某单元格写入

三、约束

1.      执行导出机器上需要装有Office组件，且Excel文件版本在2000以上

2.      读取Excel文件，在第一行必须依次存储二个范围，用于限定参数状态位，依次为：需要读取的起始单元格名称，结束单元格名称

3.      需读取的每个Excel数据文件，必须有于之配对的同名XML架构文件（扩展项可支持不同文件名，不推荐此项）

4.      写文件时，推荐先建立空Excel文件（扩展项可支持自动创建Excel文件，不推荐此项）

5.      当前版本主要实现大数据量的读写操作，对逐Cell读写及Cell格式设置方面暂不涉及

6.      其它约束按照.Net框架及Microsoft Office Excel相关约定。

四、注意事项

1.        Excel读文件目前仅支持单工作簿，单工作表读取

2.        使用读写功能时需要指定当前操作Sheet表（默认为Sheet1），请使用索引枚举EnumType.SheetIndex方式

3.        写Excel文件，提供（普通，ReWrite重写，Append追加）三种操作方式;普通方式为正常情况下对新文件写入，重写是对原数据进行覆盖性重写，追加则是在指定Sheet之后追加数据，若进行大数据量写入操作，请用此项。 “重写”和“追加”操作中，若写入时超过当前Sheet最大容量则自动创建Sheet表继续写入

4.        写入数据量的大小要求单次写入：60000行以内,255列以内，Cell值长度1-255字符，目前写操作仅支持单工作簿，最大存在32个Sheet，每Sheet最大存储量为60000行

5.        写入数据时，若不对Sheet重命名，请设置SheetName属性为空值，按照Excel约定SheetName的名称不能超过32字符

6.        本版本暂不提供数据插入功能

六、适用范围

       此操作类库适用与.NET平台下的Windows应用程序及Web应用程序

五、性能测试

       环境:WindowsXP、Pentium(R)4 CPU 2.8GHZ、512MB内存。

Excel单文件追加测试结果：

数据量           时间

5W               7S

15W              26S

25W              41S

40W              59S

50W              1:24S

60W              1:39S

60W              1:52S

100W            3:27S

六、使用方法

引用 las.foundation.Interfaces,las.foundation.ExcelManager，las.foundation.SmartExcel

       1.读取Excel文件

ReadFile
 1 DataSet ds = new DataSet();
 2
 3                            IExcelManager iex = null;
 4
 5                            try
 6
 7                            { 
 8
 9                                     iex = ExcelManagerFactory.Instance().CreateExcelManager();
10
11                                     iex.FilePath =需读取文件名;
12
13                                     if (Xml架构文件 != "")
14
15                                     {
16
17                                               iex.XMLFilePath =Xml架构文件;
18
19                                     }
20
21                                     iex.Open();
22
23                                     // 指定当前读取的工作表，用索引方式（Sheet1—Sheet32）
24
25                                     iex.ActiveSheet(EnumType.SheetIndex.Sheet1);
26
27                                     ds = iex.Read();
28
29                            }
30
31                            catch(Exception ex)
32
33                            {
34
35                                     MessageBox.Show(ex.Message.ToString());
36
37                            }
38
39                            finally
40
41                            {
42
43                                     if(iex != null)
44
45                                     {
46
47                                               iex.Close();
48
49                                     }
50
51                            }
52
53

       2.读取Cell单元格

ReadCell
 1IExcelManager iex = null;          
 2
 3                     try
 4
 5                     { 
 6
 7                            iex = ExcelManagerFactory.Instance().CreateExcelManager();
 8
 9                            iex.FilePath = 读取的文件名;
10
11if (Xml架构文件 != "")
12
13                                     {
14
15                                               iex.XMLFilePath =Xml架构文件;
16
17                                     }
18
19                            iex.Open();
20
21                                     // 指定当前读取的工作表，用索引方式（Sheet1—Sheet32）
22
23                                     iex.ActiveSheet(EnumType.SheetIndex.Sheet1);
24
25                            strRet = iex.ReadCell(单元格名称);
26
27                     }
28
29                     catch(Exception ex)
30
31                     {
32
33                            MessageBox.Show(ex.Message.ToString());
34
35                     }
36
37                     finally
38
39                     {
40
41                            if(iex != null)
42
43                            {
44
45                                   iex.Close();   
46
47                            }
48
49                     }
50
51

       3.写入文件

WriteFile
 1 IExcelManager iex = null;          
 2
 3                     string strPa = "";
 4
 5                     strPa = this.txtFileName.Text;                                                          
 6
 7                     try
 8
 9                     {
10
11                            iex = ExcelManagerFactory.Instance().CreateExcelManager();
12
13                            iex.FilePath = strPa;
14
15                            iex.DataSource = 数据源;
16
17                            iex.WriteType = EnumType.WriteType.None;
18
19                            iex.SheetName = 设置Sheet名称
20
21                            iex.OpenCreate();
22
23                                     // 指定当前读取的工作表，用索引方式（Sheet1—Sheet32）
24
25                                     iex.ActiveSheet(EnumType.SheetIndex.Sheet1);
26
27                            iex.Write();
28
29                            // 重写数据
30
31//iex.ReWrite(重写开始行);
32
33                     }
34
35                     catch(Exception ex)
36
37                     {
38
39                            MessageBox.Show(ex.Message.ToString());
40
41                     }
42
43                     finally
44
45                     {
46
47                            if(iex != null)
48
49                            {
50
51                                   iex.Close();
52
53                            }
54
55                     }
56
57

       4.写入数据至某单元格

WriteCell
 1IExcelManager iex = null;          
 2
 3                     string strPa = 写入的文件名;
 4
 5                     try
 6
 7                     {
 8
 9                            iex = ExcelManagerFactory.Instance().CreateExcelManager();
10
11                            iex.FilePath = strPa;
12
13                            iex.BackColor =背景颜色;
14
15                            iex.ForeColor =字体颜色
16
17                            iex.Font = 字体样式;
18
19                           iex.OpenCreate();                     
20
21                                               // 指定当前读取的工作表，用索引方式（Sheet1—Sheet32）
22
23                                               iex.ActiveSheet(EnumType.SheetIndex.Sheet1);      
24
25    iex.WriteCell(行，列，写入值);
26
27                            }
28
29                     catch(Exception ex)
30
31                     {
32
33                            MessageBox.Show(ex.Message.ToString());
34
35                     }
36
37                     finally
38
39                     {
40
41                            if(iex != null)
42
43                            {
44
45                                   iex.Close();   
46
47                            }
48
49                     }
50
51                                                                      
52

 

五、参考：

 

1.        .NET操作Excel COM对象

2.        Microsoft MSDN

3.        http://support.microsoft.com/default.aspx?scid=kb;zh-cn;306023

4.        http://support.microsoft.com/kb/283667/zh-cn

5.        文件创建部分参考博客园灵感之源vb.net SmartExcel及鞠强C#SmartExcel两位朋友的方法，感谢两位朋友所付出的劳动，谢谢！
            (个人意见：鉴于此方法使用组件的问题,不建议用此方法)  如有兴趣的朋友可以查看

下面是此管理类库的接口类描述，以及相关源码文档使用手册等。
在仅使用时直接引用两个管理类(在DLL.rar包中)即可。
欢迎大家指点。。。

接口类
  1/**//* -----------------------------------------------------------------------
  2 *    版权所有： 版权所有(C) 2006，EYE（Ver1.1）
  3 *    文件编号： 0003
  4 *    文件名称： IExcelManager.cs
  5 *    系统编号： E-Eye_0001
  6 *    系统名称： SFWL管理系统
  7 *    模块编号： 0001
  8 *    模块名称： Excel数据管理对象接口
  9 *    设计文档： 
 10 *    完成日期： 2006-5-12 10:33:56
 11 *    作　　者： 林付国
 12 *    内容摘要： 完成Excel数据管理对象API接口定义
 13 *    属性描述： 该接口有10个属性
 14 *                    01 DataSource            数据源
 15 *                    02 Title                Excel文件表格标题
 16 *                    03 FilePath                源文件路径
 17 *                    04 XMLFilePath            XML架构文件路径
 18 *                      05 IsOpen                判断Excel管理对象是否已经打开
 19 *                    06 WriteType            写入类型(普通，重写，追加)
 20 *                    07 SheetName            Sheet表名称
 21 *                    08 BackColor            背景颜色
 22 *                    09 ForeColor            字体颜色
 23 *                    10 Font                    字体样式
 24 *    方法描述： 该接口包括10个方法:
 25 *                    01 Open                    打开Excel管理对象
 26 *                    02 Read                    读取Excel文件中有效行列数据集
 27 *                    03 ReadCell                读取某单元格的内容
 28 *                    04 ReadCell                读取某单元格的内容，按行，列方式
 29 *                    05 Write                写入至Excel文件中
 30 *                    06 ReWrite                按照指定重写行重写数据
 31 *                    07 WriteCell            写数据至单元格
 32 *                    08 Close                资源释放
 33 *                    09 OpenCreate            打开Excel管理对象，若Excel文件不存在则创建之
 34 *                    10 ActiveSheet            激活当前读写数据的Sheet表
 35 *    文件调用：无
 36 *      约    束：1.执行导出机器上需要装有Office组件，且Excel文件版本在2000以上
 37 *                2.Excel读文件目前仅支持单工作簿，单工作表读取
 38 *                3.需读取Excel文件，在第一行必须依次存储二个范围，用于限定参数状态位，依次为：需要读取的起始单元格名称，结束单元格名称
 39 *                4.需读取的每个Excel数据文件，必须有于之配对的同名XML架构文件（扩展项可支持不同文件名，不推荐此项）
 40 *                5.写文件时，推荐先建立空Excel文件（扩展项可支持自动创建Excel文件，不推荐此项）,本版本暂不提供数据插入功能
 41 *                6.写入至Excel文件，提供（普通，Insert重写，Append追加）三种操作方式
 42 *                    数据量的大小要求单次写入：行1--60000以内,列1-255，Cell值长度1-255字符 
 43 *                    目前写操作仅支持单工作簿，最大存在32个Sheet，每Sheet最大存储量为60000行
 44 *                7.其它约束按照.Net框架及Microsoft Office Excel相关约定。
 45 *    -----------------------------------------------------------------------
 46 * */
 47
 48using System;
 49using System.Collections;
 50using System.Data;
 51
 52namespace las.foundation.Interfaces
 53{
 54    /**//// 类 编 号： 01
 55    /// 类 名 称： IExcelManager
 56    /// 内容摘要： Excel管理对象接口
 57    /// 完成日期： 2006-5-12 14:36:51
 58    /// 编码作者： 林付国
 59    public interface IExcelManager : IDisposable
 60    {
 61        Property#region Property
 62        /**//// <summary>
 63        /// 数据源
 64        /// </summary>
 65        DataSet DataSource{get;set;}
 66        /**//// <summary>
 67        /// Excel文件表格标题
 68        /// </summary>
 69        string Title{get;set;}
 70        /**//// <summary>
 71        /// 源文件路径
 72        /// </summary>
 73        string FilePath{get;set;}
 74        /**//// <summary>
 75        /// XML架构文件路径
 76        /// </summary>
 77        string XMLFilePath{get;set;}
 78        /**//// <summary>
 79        /// 判断Excel管理对象是否已经打开
 80        /// </summary>
 81        /// <returns></returns>
 82        bool IsOpen{get;}
 83        /**//// <summary>
 84        /// Excel文件写入类型
 85        /// </summary>
 86        EnumType.WriteType WriteType{get;set;}
 87        /**//// <summary>
 88        /// Sheet表名称
 89        /// </summary>
 90        string SheetName{get;set;}
 91        /**//// <summary>
 92        /// 背景颜色
 93        /// </summary>
 94        System.Drawing.Color BackColor{get;set;}
 95        /**//// <summary>
 96        /// 字体颜色
 97        /// </summary>
 98        System.Drawing.Color ForeColor{get;set;}
 99        /**//// <summary>
100        /// 字体样式
101        /// </summary>
102        System.Drawing.Font Font{get;set;}
103        #endregion
104
105        Private Method#region Private Method
106        /**//// <summary>
107        /// 打开Excel管理对象
108        /// </summary>
109        /// <returns></returns>
110        bool Open();
111        /**//// <summary>
112        /// 读取Excel文件中有效行列数据集
113        /// </summary>
114        /// <returns></returns>
115        DataSet Read();
116        /**//// <summary>
117        /// 读取某单元格的内容
118        /// </summary>
119        /// <param name="strCell">单元格名称</param>
120        /// <returns></returns>
121        string ReadCell(string strCell);
122        /**//// <summary>
123        /// 读取某单元格内容，按行列参数方式
124        /// </summary>
125        /// <param name="iRow"></param>
126        /// <param name="iCol"></param>
127        /// <returns></returns>
128        string ReadCell(int iRow,int iCol);
129        /**//// <summary>
130        /// 写入数据集到Excel文件
131        /// </summary>
132        /// <returns></returns>
133        bool Write();
134        /**//// <summary>
135        /// 重写数据集到Excel文件,指定重写行
136        /// </summary>
137        /// <param name="iRow"></param>
138        /// <returns></returns>
139        bool ReWrite(int iRow);
140        /**//// <summary>
141        /// 写数据至单元格
142        /// </summary>
143        bool WriteCell(int iRow,int iCol,string strValue);
144        /**//// <summary>
145        /// 活动的Sheet表
146        /// </summary>
147        /// <param name="sheetindex"></param>
148        void ActiveSheet(EnumType.SheetIndex sheetindex);
149        /**//// <summary>
150        /// 资源释放
151        /// </summary>
152        void Close();
153        /**//// <summary>
154        /// 打开并创建此对象
155        /// </summary>
156        /// <returns></returns>
157        bool OpenCreate();
158        #endregion
159    }
160}
161

1.使用说明
word使用手册
相关DLL文件

2.所有源码
sourcecode1
sourcecode2
(可以下载了，下载后把文件解压到某一文件夹中即可)