Command对象的常用方法
说明:上篇总结了Command对象的几个数据成员,这节总结Command对象的常用方法。
同样,在不同的数据提供者的内部,Command对象的名称是不同的,在SQL Server Data Provider里叫SqlCommand,而在OLE DB Data Provider里叫OleDbCommand。
下面将详细介绍Command类型对象的常用方法,包括构造函数、执行不带返回结果集的SQL语句方法、执行带返回结果集的SQL语句方法和使用查询结果填充DataReader对象的方法。
1.构造函数
构造函数用来构造Command对象。对于SqlCommand类型的对象,其构造函数说明如表 2-6所示。
函数定义 |
参数说明 |
函数说明 |
SqlCommand() |
不带参数 |
创建SqlCommand对象 |
SqlCommand(string cmdText) |
cmdText: SQL 语句字符串 |
根据SQL语句字符串,创建SqlCommand对象 |
SqlCommand(string cmdText, SqlConnection connection) |
cmdText: SQL 语句字符串 connection: 连接到的数据源 |
根据数据源和SQL语句,创建SqlCommand对象 |
SqlCommand(string cmdText, SqlConnection connection, SqlTransaction transaction) |
cmdText: SQL语句字符串 connection: 连接到的数据源 transaction: 事务对象 |
根据数据源和SQL语句和事务对象,创建SqlCommand对象 |
(1) 第一个构造函数不带任何参数
SqlCommand cmd=newe SqlCommand(); cmd.Connection=ConnectionObject;
string CommandText=" select *from studentInfo "; cmd.CommandText=CommandText;
上面代码段使用默认的构造函数创建一个SqlCommand对象。然后,把已有的Connection对象ConnectionObject和命名文本CommandText分别赋给了Command对象的Connection属性和CommandText属性。
除此之外,许多关系型数据库,例如SQL Server 和Oracle,都支持存储过程。可以把存储过程的名称指定为命名文本。例如,使用编写 GetAllStudent存储过程为命名文本:
string CommandText=" GetAllStudent "; cmd.CommandType=CommandType.StoredProcedure;
cmd.CommandText=CommandText;
(2) 第二个构造函数可以接受一个命令(SQL)文本
string CommandText=" select *from studentInfo "; SqlCommand cmd=newe SqlCommand(CommandText); cmd.Connection=ConnectionObject;
上面的代码实例化了一个Command对象,并使用给定命令文本对Command对象的CommandText属性进行了初始化。
然后,使用已有的Connection 对象对Command对象的Connection属性进行了赋值。(这种方法在上一篇说过,不建议使用,使用最多的是下面的方法)
(3) 第三个构造函数接受一个Connection和一个命名文本
SqlCommand cmd=newe SqlCommand(CommandText, ConnectionObject);
注意这两个参数的顺序,第一个为string类型的命令文本,第二个为Connection对象。
(4) 第四个构造函数接受三个参数,第三个参数是SqlTransaction对象,这里不做讨论。
另外,Connection 对象提供了CreateCommand方法,该方法将实例化一个Command对象,并将其Connection属性赋值为建立该Command对象的Connection对象。
无论在什么情况下,当把Connection对象赋值给Command对象的Connection属性时,并不需要Connection对象是打开的。但是,如果连接没有打开,则在命令执行之前必须首先打开连接。
而对于OleDbCommand类型的对象,其构造函数如下表所示。同样可以看出,它们和SqlCommand类的构造函数非常相似。
函数定义 |
参数说明 |
函数说明 |
OleDbCommand() |
不带参数 |
创建OleDbCommand对象 |
OleDbCommand(string cmdText) |
cmdText: SQL语句字符串 |
根据SQL语句字符串,创建OleDbCommand对象 |
OleDbCommand(string cmdText,OleDbConnection connection) |
cmdText: SQL语句字符串 connection:连接到的数据源 |
根据数据源和SQL语句,创建OleDbCommand对象 |
OleDbCommand(stringcmdText, OleDbConnection connection , OleDbTransaction transaction) |
cmdText: SQL语句字符串 connection:连接到的数据源 transaction:事务对象 |
根据数据源和SQL语句和事务对象,创建OleDbCommand对象 |
命令对象构造完成后,就可以执行命令对数据库进行操作了。命令对象所提供的用于执行命令的方法有很多种,具体使用哪个方法取决于命令的执行结果返回什么样的数据。
SqlCommand 提供了4个执行方法:ExecuteNonQuery()、ExecuteScalar()、ExecuteReader()、ExecuteXmlReader()。
详细见下面相关部分。
命令对象提供的用于执行命令的方法及其含义如表
方法 |
含义 |
Cancel |
试图取消命令的执行 |
ExecuteNonQuery |
对连接执行SQL语句并返回受影响的行数 |
ExecuteReader |
执行查询,将查询结果返回到数据读取器(DataReader)中 |
ExecuteScalar |
执行查询,并返回查询所返回的结果集中第一行的第一列。忽略额外的列或行 |
ExecuteXmlReader |
执行查询,将查询结果返回到一个XmlReader对象中 |
2.ExecuteNonQUery方法
ExecuteNonQuery方法用来执行Insert、Update、Delete等非查询语句和其他没有返回结果集的SQL语句,并返回执行命令后影响的行数。
如果Update和Delete命令所对应的目标记录不存在,返回0。如果出错,返回-1。
String cnstr="server=(local);database=student; Integrated Security=true"; SqlConnection cn=new SqlConnection(cnstr); cn.Open(); string sqlstr="update student set name='Jone' where name='Bill' "; SqlCommand cmd=new SqlCommand(sqlstr, cn); cmd.ExecuteNonQuery(); cn.Close();
3.ExecuteScalar()方法
在许多情况下,需要从SQL语句返回一个结果,例如客户表中记录的个数,当前数据库服务器的时间等。
ExecuteScalar方法执行一个SQL命令,并返回结果集中的首行首列(执行返回单个值的命令)。如果结果集大于一行一列,则忽略其他部分。
根据该特性,这个方法通常用来执行包含Count、Sum等聚合函数的SQL语句。
下面的代码读取数据库中表student的记录个数,并把它输出到控制台上。 String cnstr="server=(local);database=student; Integrated Security=true"; SqlConnection cn=new SqlConnection(cnstr); cn.Open(); string sqlstr="select count(*) from student"; SqlCommand cmd=new SqlCommand(sqlstr, cn); object count=cmd.ExecuteScalar(); Console.WriteLine(count.ToString()); cn.Close(); ExecuteScalar()方法的返回值类型是Object,根据具体需要,可以将它转换为合适的类型。
4.ExecuteReader()方法
ExecuteReader()方法执行命令,并使用结果集填充DataReader对象。
ExecuteReader()方法用于执行查询操作,它返回一个DataReader对象,通过该对象可以读取查询所得的数据。
ExecuteReader()方法在Command对象中用得比较多,通过DataReader类型的对象,应用程序能够获得执行SQL查询语句后的结果集。
该方法的两种定义为:
ExecuteReader(),不带参数,直接返回一个DataReader结果集。
ExecuteReader(CommandBehavior behavior),根据behavior的取值类型,决定DataReader的类型。
如果behavior取值是CommandBehavior.SingleRow这个枚举值,则说明返回的ExecuteReader只获得结果集中的第一条数据。
如果取值是CommandBehavior.SingleResult,则说明只返回在查询结果中多个结果集里的第一个。
一般来说,应用代码可以随机访问返回的ExecuteReader列,
但如果behavior取值为 CommandBehavior.SequentialAccess,则说明对于返回的ExecuteReader对象只能顺序读取它包含的列。
也就是说,一旦读过该对象中的列,就再也不能返回去阅读了。这种操作是以方便性为代码换取读数据时的高效率,需谨慎使用。
String cnstr="server=(local);database=student; Integrated Security=true";
SqlConnection cn=new SqlConnection(cnstr);
cn.Open();
string sqlstr="select * from student";
SqlCommand cmd=new SqlCommand(sqlstr, cn);
SqlDataReader dr=cmd.ExecuteReader();//建立SqlDataReader 对象
while(dr.Read())//循环输出每一条记录
{
String name=dr["姓名"].ToString();//读取姓名子段
Console.WriteLine(name);//控制台输出
}
dr.Close();//关闭结果集
cn.Close();//关闭数据库连接
这段代码从数据库的student表中读取全部数据,并把该表的“姓名”字段的数据全部输出到控制台上。
ExecuteXmlReader
SqlCommand特有的方法,OleDbCommand无此方法。该方法执行将返回XML字符串的命令。它将返回一个包含所返回的XML的System.Xml.XmlReader对象。