C#与数据库访问技术总结(五)之Command对象的常用方法

时间:2022-01-28 16:49:33

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对象。