命令类XuguCommand
功能
此类主要作用是设置 sql 语句与数据库进行交互,一般可以执行的语句按功能可以分为:查询语句,插入语句,修改语句,删除语句,设定某些属性的语句,执行存储过程或函数的语句等。
说明
根据用户的执行目的和对结果的需求不同,提供不同的执行方法供用户进行选择,但均需有 XuguConnection 对象作为连接成员,且在执行命令时需要保证连接是打开的。当 sql 中带有参数信息时,XuguCommand 类中需设定执行时所需的参数信息,参数一般放在参数集合成员变量 Parameters 内部。
类属性介绍
属性 | 说明 |
---|---|
Connection | 连接成员,为XuguConnection类的对象,需注意执行方法时,保证连接是open状态,否则语句执行失败 |
CommandText | 命令执行的sql语句。若执行的是存储过程或存储函数,则此处只需填写存储过程或函数的名称,若是包内的过程或函数,则需以“包名.过程名”这样的格式填写。当填写的内容是存储过程或包时,需要将属性CommandType设定为StoreProcedure |
CommandType | 命令类型。可设定为一般语句和存储过程两类。默认情况此处类型是一般语句。当执行存储过程时,此处设值为StoreProcedure |
Parameters | 参数集成员,在有参数的情况下,提供增添和修改参数的集合,为执行特定的带参数sql 提供参数支持 |
Use_Server_Cursor | 使用服务器端游标开关。当此属性设置为true时,对select查询数据的语句有效,此时查询的结果集数据将存放于服务器端,而不是缓冲在本地 |
Transaction | 在显式设定了事务的情况下,可以进行事务操作,但是这个不推荐在命令处使用,而是一般在连接上设定事务,由连接对事务进行统一的提交和回滚操作 |
类方法介绍
方法 | 参数 | 返回值 | 说明 |
---|---|---|---|
XuguCommand(string cmd_sql,XuguConnection conn) | cmd_sql:sql 语句,conn:连接对象 | - | 带 sql 与连接信息的构造函数,一步设定连接变量与 sql 语句变量 |
ExecuteNonQuery() | - | 成功:≥0;失败:-1 | 执行非查询型的 sql 语句。当 sql 为 select 语句时直接返回-1;当语句为 insert、update 或 delete 时,返回在数据库中所影响的行数。一般的设置型语句也是通过此函数执行。(说明: 此方法无需接收结果集。但如需要达到一定输出的目的,可以用此方法执行带输出参数的存储过程,以输出参数达成目的输出) |
ExecuteReader() | Conn_str:连接字符串 | 成功:0;失败:-1 | 此函数用于执行能返回结果集的查询语句。当需要服务器端缓存数据时,请提前设定 Use_Server_Cursor 的值。此函数返回值为 XuguDataReader 对象,是遍历结果集的一个对象 |
ExecuteScalar() | - | 成功:0;失败:-1 | 此函数返回结果集的首行首列,因此一般用于执行统计类查询比较多(类似 select count() 这类的),一般结果集也可以返回首行首列的数据 |
Dispose() | - | - | 资源释放函数,调用此函数会释放申请的资源,对引用的资源的减少引用的统计次数 |