连接类XuguConnection
功能
连接类的主要作用是连接数据库,为语句类XuguCommand提供连接基础,也可以为事务类XuguTransaction提供事务环境基础。
说明
连接打开方式是使用Open函数,连接关闭方式是使用Close函数。
在使用连接池时,打开连接的函数略有不同,且关闭连接使用Close函数时也不是真的关闭连接,而是将连接释放到连接池。
类属性介绍
属性 | 说明 |
---|---|
ConnectionString | 连接串属性,里面是各个连接参数的键值对,包括IP(或IPS)、DBNAME、USER、PASSWORD、Port、CHARSET等。其中IP是指连接的服务器端的IP地址,IPS是指多IP创建连接(IP与IP之间使用逗号间隔),DBNAME是连接的数据库名,User是用户名,Password是用户对应的口令,Port表示连接的端口信息,Charset是指连接的用户端使用的字符集,当客户端的字符集与连接的字符集不匹配时,输出的中文等数据可能会有乱码信息 |
State | 连接状态信息。分为open,closed,Connecting,Executing,Fetching,Broken等 |
DataSource | 连接服务器端信息(IP地址) |
Database | 连接的数据库信息 |
类方法介绍
方法 | 参数 | 返回值 | 说明 |
---|---|---|---|
Open() | - | - | 打开数据库连接。如果网络不通,或者服务器端的连接信息有误,或者服务器关闭,那么此函数会抛出异常 |
Close() | - | - | 关闭数据库连接。在启动连接池的情况下,不会关闭连接,而是将连接归还连接池 |
XuguConnection(string conn_str) | Conn_str:连接字符串 | - | 带连接串的构造函数 |
Dispose() | - | - | 释放连接资源 |
BeginTransaction() | - | XuguTransaction对象 | 在当前连接中启动事务环境,这样在后续的操作集合体时,可以根据需要进行提交确认或者集体回滚 |
CreateCommand() | - | XuguCommand对象 | 以当前连接为连接属性创建XuguCommand对象 |