CSFramework.DB 功能介绍

CSFramework.DB多数据库-功能介绍

 

2.1 CSFramework.DB组成

CSFramework.DB由多数据库底层接口组件及实体对象数据框架构成,能满足开发企业级超大型软件系统的需求。

2.2 IDatabase核心接口体系架构

开发框架为用户提供多种数据库支持,目前已封装三种底层数据驱动,支持SqlServer、Oracle、MySql三种常用数据库。多数据库架构采用策略模式设计,定义IDatabase通用接口,并实现DatabaseMSSQL、DatabaseMySql、DatabaseOracle三个数据库操作类,在应用系统时引用这个类库文件:CSframework.DB.dll。 

2.3 DbFramework体系架构

2.3.1 DbFramework简介

DbFramework是CSFramework.DB基于ADO.NET多数据库底层组件包封装的一个通用工具类,能根据对象实体模型(表结构映射ORM)自动提交数据,针对实体对象的Add、Delete、Update、Select操作,开发人员不需要编写任何SQL脚本。特点:支持批量对象操作。支持事务。支持MsSQL,MySQL,Oracle三种数据库。

 

2.3.2 DbFramework组成

1. DbFramework:CSFramework通用对象模型数据更新框架。

2. DbCommandGenerator: DbCommand命令生成器。

根据.NET对象模型(Type)类型自动生成三种DbCommand命令对象,支持MsSQL,MySQL,Oracle三种常用数据库。

3. DbFramework依赖CSFramework.DB的IDatabase接口。

 

2.3.3 DbFramework接口

 关于DbFramework

DbFramework组件框架是基于CSFramework.DB核心库衍生出来的一个实体模型框架,用于提交实体模型数据,支持Add,Delete,Select 对象。

 

2.4 CSFramework.DB.dll几个核心类视图

 

2.4.1 IDatabase接口说明

 IDatabase: 数据库核心接口,提供数据库连接以及数据操作相关方法,具体方法参考下图:

序号

名称

类型

参数

说明

1

DefaultPort

属性

 

默认端口

2

CommandTimeout

属性

 

命令超时

3

ConnectionTimeout

属性

 

连接时间

4

DateTimeType

属性

 

日期时间类型

5

ToDbType

方法

 

数据库类型转换为通用的System.Data.DbType

6

ToNetType

方法

 

MySQL数据库类型转换为通用的.NET对象类型(Type)

7

GetServerTime

函数

 

创建获取服务器时间

8

ConnectionString

属性

 

连接字符串

9

TransBegin

方法

 

启动事务

10

TransCommit

方法

 

提交事务

11

TransRollback

方法

 

事务回滚

12

GetDataSet

函数

 

获取数据集

13

GetDataSet

函数

Cmdsql命令

获取数据集

14

GetDataSet

函数

Texttypeparas

文本、类型、段落

获取数据集

15

GetTable

函数

 

获取表

16

GetTable

函数

Cmdsql命令

获取表

17

GetDataRow

函数

 

获取数据行

18

ExecuteSQL

方法

 

执行SQL

19

ExecuteCommand

方法

 

执行命令

20

ExecuteScalar

方法

SQL

执行SQL,返回第1行第1列数据

21

ExecuteScalar

方法

Cmdsql命令

执行SQL,返回第1行第1列数据

22

ExecuteReader

方法

SQL

执行读卡器

23

ExecuteReader

方法

Cmdsql命令

执行读卡器

24

ExecuteReader<T>

方法

 

执行读卡器,支持泛型对象转换

25

ExecuteReader<T>

方法

 

执行读卡器,支持泛型对象转换

26

ExecuteReader<T>

方法

 

执行读卡器,支持泛型对象转换

27

ExecuteReader<T>

方法

 

执行读卡器,支持泛型对象转换

28

ExecuteTrans

方法

 

执行事务处理

29

ExecuteTrans

方法

 

执行事务处理

30

Close

方法

 

关闭连接

31

DatabaseType

属性

当前数据库类型

SqlServer,Oracle, MySQL

32

GetTop

函数

 

SELECT TOP 通用方法

33

ExecuteReaderList <T>

方法

 

返回对象列表

34

GetStringList <String>

函数

 

返回指定字段的列表

35

ParseParamName

方法

 

拼接参数,如:@A, ?pA, :A

 

2.4.2 IAdoFactory接口说明

 IAdoFactory:ADO(ActiveX Data Object)ADO.NET活动数据对象工厂,创建ADO.NET核心组件的对象实例,如:DbConnection, DbCommand, DbParameter, DbDataAdapter等。

序号

名称

类型

参数

说明

1

BuildConnectionString

方法

 

创建SQL连接字符串

2

CreateSqlProc

方法

 

创建SQL存储过程

3

CreateCommand

方法

commandText: SQL命令

创建命令

4

ParamSymboName

属性

 

参数符号,如@/:/?

5

CreateTimestampParameter

方法

 

创建时间戳参数

6

CreateConnection

方法

 

创建连接

7

CreateConnection

方法

connectionString:连接字符串

创建连接

8

CreateCommand

方法

commandTypeSQL命令

创建命令

9

CreateParameter

方法

 

创建参数

10

CreateParameter

方法

Size,sourceColumn,parameterValue:大小、源列、参数值

创建参数

11

CreateCommandBuilder

方法

 

创建数据库SQL命令生成器

13

CreateDataAdapter

方法

eventHandler:事件处理程序

创建数据适配器。

 

2.4.3 DatabaseFactory类说明

DatabaseFactory:数据库工厂,根据数据库类型创建数据库实例。

序号

名称

类型

参数

说明

1

CommandTimeOut

属性

 

命令超时定义

2

ConnectionTimeOut

属性

 

连接超时定义

3

CreateMDB

方法

 

创建数据库实例

4

CreateSqlDatabase

方法

 

创建SQL数据库

5

CreateMySqlDatabase

方法

 

创建MySQL数据库

6

CreateOracleDatabase

方法

 

创建Oracle数据库

7

CreateDatabase

方法

 

创建数据库

8

CreateDatabase

方法

 

创建数据库

9

GetADOFactory

方法

 

ADO组件工厂

10

SetTimeOut

方法

 

更改连接字符串的超时时间

2.4.4 DatabaseMDB类说明

DatabaseMDB: 通用多数据库底层驱动(支持SqlServer,MySQL,Oracle三种数据库)。若使用DatabaseMDB类,需要参照以下部署才能使用:

1. 依赖app.config文件,需要配置数据库提供者。参考:CSFramework.DB的app.config文件。

2. 将app.config文件内容复制到应用程序的主配置文件,如web.config或app.config,因程序内使用AppSettings.Current["ConnectionTimeout"],以及加载Oracle,MySql,SqlServer三个底层驱动,

如:System.Data.SqlClient, Oracle.ManagedDataAccess.Client, MySql.Data.MySqlClient。

 

2.4.5 DataProviderFactory类说明

DataProviderFactory:数据提供者(DbProviderFactory)工厂类,用于加载基于.NET底层的数据库驱动,如:System.Data.SqlClient, Oracle.ManagedDataAccess.Client, MySql.Data.MySqlClient, System.Data.OracleClient。

序号

名称

类型

参数

说明

1

Dictionary

方法

 

字典

2

Dictionary

方法

 

字典

3

DataProviderFactory

方法

 

数据提供程序工厂

4

GetProviderInvariantName

方法

 

获取指定数据库类型对应的程序集名称

5

GetFactory

方法

 

从缓存获取指定类型的数据库对应的DbProviderFactory

6

CreateDbProviderFactory

方法

 

加载指定数据库类型的DbProviderFactory

 

 需要在app.config文件内定义数据库底层驱动的参数。

 

2.4.6 CommandHelper类说明

序号

名称

类型

参数

说明

1

_cmd

成员

 

DbCommand

2

_db

成员

 

IDatabase

3

_paramPrefix

成员

 

参数前锥

4

CommandHelper

方法

 

构造器

5

Command

方法

 

SqlCommand对象

6

ClearParam

方法

 

清除参数

7

ParseParamName

方法

 

返回包含参数符号的参数名称

8

RemoveParam

方法

 

删除参数

9

AddParam

方法

dbType:数据库类型

增加参数

10

AddParam

方法

 

增加参数

11

AddParam

方法

 

增加参数

12

AddParamOracleCursor

方法

 

添加参数Oracle游标

13

SetValue

方法

 

SqlCommand.Parameters赋值

14

GetValue

函数

 

获取参数的值

15

GetParameter

函数

 

DbParameter

16

ParamPrefix

属性

 

参数符号,如:@A, ?p_A, :A

 

2.4.7 ParameterHelper类说明

序号

名称

类型

说明

1

DbParameter

方法

添加参数

2

AddParameter

方法

添加参数

2.4.8 DatabaseType枚举说明

 DatabaseType:数据库类型,枚举类型。预设支持三种数据库。

2.4.9 DatabaseMSSQL类说明

 DatabaseMSSQL:封装Microsoft SQL Server数据库常用操作方法。

2.4.10 DatabaseOracle类说明

 DatabaseOracle:封装Oracle数据库常用操作方法。

 接口方法参考DatabaseMSSQL。

2.4.11 DatabaseMySQL类说明

 DatabaseMySQL:封装MySQL数据库常用操作方法。

 接口方法参考DatabaseMSSQL。

2.5 debug文件说明

 CSFramework.DB.dll:多数据库核心类库。

 CSFramework.DB.dll.config:由app.config生成的配置文件。

 CSFramework.DBTester.exe:测试程序。

 MySql.Data.dll:MySql数据库第三方供应商提供的底层驱动组件。

 Oracle.ManagedDataAccess.dll:Oracle数据库第三方供应商提供的底层驱动组件。

 System.Data.OracleClient.dll:微软自带的Oracle数据库底层驱动。

2.6 VS解决方案

 CSFramework.DB:多数据库核心工程项目。

 CSFramework.DBSqlServer:为SqlServer数据库用户定制的类库(工程项目)。

 CSFramework.DBTester:测试程序。

 

C/S框架网|原创精神.创造价值.打造精品

版权声明:本文为开发框架文库发布内容,转载请附上原文出处连接
C/S框架网
发表评论

评论内容
昵称:
关联文章

CSFramework.DB 功能介绍
CSFramework.DB VS解决方案
CSFramework.DB开源组件
CSFramework.DB架构图
CSFramework.DB 软件简介
CMS - 功能介绍
C#-C/S结构系统框架 - 功能介绍
CSFramework.DB 运行环境
CS开发框架版本介绍(www.csframework.com)
CSFramework.DB多数据库支持组件DbDataUpdate.UpdateObject详解
Winform快速开发框架之权限系统设计(2) - 功能模块介绍
CSFramework旗舰版快速开发框架目录结构以及解决方案介绍
frmBaseDataDictionary类成员介绍
C/S架构进销存快速开发框架开发模板功能介绍
CSFramework.DB多数据底层类库测试程序(测试报告-2021)
CSFramework开发框架主窗体模块容器主界面介绍
CSFramework.DB多数据底层类库(IDatabase/DbDataUpdate)接口测试报告
测试CSFramework.DB数据底层组件IDatabase.GetTop方法(Mssql/MySql)
CSFramework.DB关于设置全局变量CommandTimeOut/ConnectionTimeOut的测试案例
CSFramework.DB-扩展命令超时和连接超时参数设置|C/S框架网