通用类库与扩展控件介绍0708.doc

通用类库与扩展控件介绍1 类库与扩展控件分类1.1 类库内容u 数据库操作类库（SLECC.DBUtility）u 基本通用方法类库(SLECC.COM.Utility)u CS操作通用方法类库(SLECC.CS.Utility)u BS操作通用方法类库(SLECC.BS.Utility)u BS操作扩展控件(SLECC. BS. Ctrl.Extend)u 日志操作类库（SLECC.LogManage）u Engine操作类库(SLECC.GIS.Engine) u GIS业务操作类库(SLECC.BLL.GIS)1.2 类库命名空间划分方法顶级命名空间为：“SLECC”。1、 命名空间名词说明数据库类命名空间为：”DBUtility”通用方法命名空间为：”COM”控件扩展类命名空间为:”Ctrl”日志操作类命名空间为：”LogManage”GIS方法命名空间为：”GIS”业务逻辑层命名空间为:“BLL”数据访问层命名空间为：”DAL”数据模型层命名空间为：“Model”2、 通用类命名空间划分方法基本操作类:UtilityBS操作基本方法类：BS.UtilityCS操作基本方法类：CS.Utility3、 数据访问层命名空间划分方法按照项目的要求在DAL命名空间下进行详细划分。如：用户管理通用数据操作类 SLECC.DAL.UserManage4、 业务逻辑层命名空间划分方法按照项目的要求在BLL命名空间下进行详细划分:如：用户管理通用业务类 SLECC.BLL.UserManage5、 数据模型层命名空间划分方法按照项目的要求在Model命名空间下进行详细划分:如：用户管理通用数据模型类 SLECC.Mode.UserInfo6、 具体项目类库划分方法在顶级命名空间”SLECC”下添加具体项目名称(例如：原油集输项目， 在SLECC后添加Yyjs命名空间)，组成与项目有关的类库。数据访问层，业务逻辑层等参照通用类库的划分方法。以原油集输项目为例：数据操作类：SLECC.Yyjs.DAL业务操作类：SLECC.Yyjs.BLL数据模型类：SLECC.Yyjs.Model1.3 类库分类结构n SLECCu (Tecl)通用技术 (该层可略写)l (COM)通用功能 (该层可略写)n Utilityn LogManagen DBUtility l BSn Utilityn Ctrlu Extendl CSn Utilityn Ctrlu Extendl LogManageu GIS l Enginel SkyLineu DAL 数据接口层u IDAL可选u BLL 业务逻辑层u IBLL可选u Model 数据模型层u (Project)具体项目，例如:l Yyjs(原油集输项目)l Dmxx(地面建设信息系统)2 类库与扩展控件结构与功能介绍2.1 数据库操作（SLECC.DBUtility）u 结构关系1. DataBaseHelper继承于IDataBaseHelper接口2. databaseHelperOracleNoClient继承于IDataBaseHelper接口和dataBaseHelperu 功能特点介绍1. 支持三种数据库的操作OracleSqlServerAccess2. 支持无Oracle客户端的数据库操作3. 支持接口操作4. 支持事务类型的任务操作5. 支持对CLOB,BLOb等大字段类型的操作6. 支持工厂生成模式和单例生成模式7. 支持直连查询和离线查询数据库u 具体功能介绍IDataBaseHelper接口包括2个属性和35个函数，通过属性可以查看数据库的状态。通用函数可以对数据库进行操作，该类基本能满足开发的需要。函数分类如下：1. 按操作对象可分为： 一般SQL语句操作，如： / / 执行SQL语句，返回影响的记录数 / / SQL语句 / 影响的记录数 int ExecuteSql(string SqlString);可执行“Select * from sys_usr where id=Test”等语句。 带执行参数数组的SQL语句,如 ExecuteSql(string SqlString, params IDataParameter iParms);，可执行语句“select * from username where id=:id” ，参数为IDataParameter数组。 存储过程操作，包括带参数和不带参数两种，如： / / 执行存储过程 / / 存储过程名 / 存储过程参数 / SqlDataReader IDataReader RunProcedure(string storedProcName, IDataParameter parameters); 对XML进行操作 / / 执行查询语句，向XML文件写入数据 / / 查询语句 / XML文件路径 void WriteToXml(string SqlString, string xmlPath);2. 按执行结果可分为： Void类型函数 Boolean类型函数 得到Object类型函数 得到DataTable类型函数 得到DataSet类型函数 得到DataReader类型函数 得到DataView类型函数 得到Btype类型函数3. 扩展操作方法(clsDbCOM) 计算一张表最大ID 计算一张表的记录数 删除记录 得到单个的int、string等类型数据2.2 基本通用方法(SLECC.COM.Utility)u 功能介绍该类库作为通用操作方法的基类，在B/S类系统或者C/S类系统中可以对该类库中的类文件进行继承。该一共20个类文件，主要功能如下：1. Base64加密(clsBase64)2. 汉字及全半角相关操作(clsChineseOperate)3. 数据表DataTable操作(clsDatatableOperate) 数据表生成 数据表筛选、合并等4. 日期相关操作方法(clsDateOperate) 设置数据库的日期接受格式 对日、周、旬、月、年的相关操作 时间字符串格式化5. EXCEL各种操作方法(clsExcelOperate，clsSmartExcelOperate) 不使用微软EXCEL的插件 速度快(3分钟可导出5万条数据) 对Excel中的sheet进行操作 读取、设置单元格的值 Excel格式操作，如：合并单元格 Excel的打印6. 文件各种操作方法(clsFileOperate) 文件大小计算 文件读写操作7. 各种格式校验(clsFormateCheck) 字符串格式 数字格式 日期格式 IP格式 邮箱格式8. 身份证相关函数操作(clsIdentificationCard) 身份证18位与15位的转换9. 图片操作函数(clsImage) 图片按比例缩小10. MD5加密函数(clsMd5)11. 随机对象生成(clsRandObject)，包括字符串、数字12. 字符串的操作(clsStrUtil) 格式化字符串 字母大小写转换 计算指定字符串出现次数13. 定时器操作(clsTimerOperater) 事件定时操作 时间相关计算14. XML文件操作(clsXmlEdit) Xml文件的创建 Xml节点的插入、更新、删除、查询15. 压缩文件操作(clsRarOperate, clsZipOperate) 文件的压缩与解压缩 字符串的压缩与解压缩 压缩文件信息查看16. IP相关操作(clsIpOperate) IP格式校对 判断ip是否在区域内 检查IP是否符合指定规则17. 图片水印操作(clsPainter) 文字水印 图片水印 替换图片中的指定颜色2.3 BS操作通用方法(SLECC.COM.BS.Utility)u 结构关系clsStrUtilBS继承于SLECC.COM.Utility中的clsStrUtil类u 功能介绍1. 字符串操作类(ClsStrUtilBS)，继承自clsStrUtil，扩展功能包括 网页上字符串换行 网页相关字符串函数2. 树控件操作(absTreeOperate) 该类抽象类不能直接实例化，必须根据需要继承使用，可以对其中七个函数进行重写。 支持有多个根结点的树 可以对结点进行增加、删除、更新、排序操作3. 绑定事件(clsBind) DropDownList控件绑定 GridView控件绑定4. Cookie操作相关函数(clsCookie)5. 文件下载(clsDownLoad)6. 数据表导出(clsExport)支持四种格式的数据导出：XlsCsvDoctxt7. 消息对话框(clsMessage)8. 网页中常用函数(clsWebCommon)9. 网页中表格相关函数(clsWebTable)10. 网页打开(clsWindowOpen) 指定位置弹出窗口 弹出无状态栏窗口2.4 CS操作通用方法(SLECC.COM.CS.Utility)u 结构关系ClsExcelCsOperate继承于SLECC.COM.Utility中的clsExcelOperate类u 功能介绍1. Excel相关操作(clsExcelCsOperate),继承自clsExcelOperate，扩展功能如下： GridView控件内容导出到Excel中2. 绑定事件(clsBind) GridView控件绑定3. 磁盘信息(DiskInfo) 磁盘名称 磁盘空间信息，包括空间大小、剩余空间4. 进程信息(ProcessInfo)5. 系统信息(SystemInfo) CPU个数 CPU占用率 可用内存 物理内存 分区信息 进程列表 结束指定进程 查找应用程序标题2.5 地面项目GIS操作业务类(SLECC.BLL.GIS)u 功能介绍油田地面项目中数据按照油田制定的标准进行入库，并在入库后能够根据坐标生成地图。 属性数据及坐标数据按标准进行检查 属性及坐标数据入库(clsREadExcelFile，clsSaveExcelToDatabase) 坐标成图队列生成及队列入库(clsOrderQueue，clsEditQueue) 根据队列内容生成地图(clsService)2.6 Engine操作类(SLECC.GIS.Engine)u 功能介绍1. ArcIMS相关操作 ArcIMS服务器状态查询 ArcXML构建 ArcXML服务器结果处理2. 54地图投影转换3. ArcSDE相关操作 SDE要素数统计、编辑、删除4. 几何形体对象(Geometry)操作 根据坐标和类型得到一个Geometry对象 根据Geometry计算坐标5. 地理数据导入导出 把SDE的数据备份到本地mdb数据库 把SDE的数据备份到本地Shapefile目录 将access数据导入SDE数据库 源数据到目的数据库的拷贝 地理数据的信息查询6. 地理数据统计 统计数据集中的图层个数 统计指定图层中要素的个数 长度、面积统计2.7 BS操作扩展控件(SLECC.Cntrl.BS.Extend)u 功能介绍一共有七个控件，包括对DropDownList控件、Label控件、ListBox控件、TreeView控件、分页控件。1. dropDownList控件 可输入下拉框 可分组式下拉框2. ListBox控件可分组式列表框3. GridView控件 鼠标经过行的时候改变该行的样式，鼠标离开行的时候恢复该行的样式 对多个字段进行复合排序；升序、降序的排序状态提示 联动复选框（复选框的全选和取消全选）。 固定指定行、指定列，根据RowType固定行，根据RowState固定行 响应行的单击事件和双击事件，并在服务端处理 行内复选框选中的时候改变该行的样式 导出数据源的数据为Excel、Word或Text（应保证数据源的类型为DataTable或DataSet） 给数据行增加右键菜单，响应服务端事件或超级链接 自定义分页样式，默认带三种分页样式。 合并指定列的内容（相邻且内容相同的单元格）4. Label控件 实现回发(Postback)功能。通过注册HiddenField控件，使Label控件支持回发(Postback)功能5. TreeView控件联动复选框（复选框的全选和取消全选）。选中指定的父复选框，则设置其所有子复选框为选中状态；6. 分页控件自定义分页样式，默认带三种分页样式。 Default Numeric（还有问题） PreNext2.8 日志操作（SLECC.LogManage）u 功能介绍所有的Log类都继承ILogManage接口，在CS和BS系统下均可使用。现在只支持把日志按日期写入到文件中。1. 日志输出到文件(clsLogToFile) 按日期保存日志 有Info和Error两个级别。 记录日志并能自动跳转到错误处理页。 跟踪出错的位置及出错原因2. 错误信息处理(clsExProcess)3. 获取Oracle出错信息(clsOracleException)根据Oracle出错信息代号，返回汉语错误信息3 实例展示3.1 类库实例展示u 树控件操作(absT