ADO.NET入门教程之Command对象与数据检索

1. 准备

      学习知识最快也最好的方法，那就是将理论与实践相结合。为了帮助大家更好的理解和掌握Command对象，我也准备了很多实践的例子。我希望大家能做好充分的准备，这样的话不至于在实践的时候手忙脚乱。您需要准备以下几件事情：

（1）确保你的电脑装有SQL Server 2005/2008数据库服务器。如果未装有SQL Server服务器，点此下载 SQL Server 2008 EXPRESS R2。

（2）创建一个名为db_MyDemo的数据库。

USE master;
GO
CREATE DATABASE db_MyDemo
ON
(
  NAME = MyDemo_data, /*指定文件的逻辑名称*/
  FILENAME = 'D:\mydemo_dat.mdf',/*物理文件名称*/
  SIZE = 10,/*指定文件大小，单位MB*/
  MAXSIZE = 50,/*文件最大值，单位MB*/
  FILEGROWTH = 5  /*自动增量*/
)
LOG ON
(
   Name = MyDemo_log,
   FILENAME = 'D:\mydemo_log.ldf',
   SIZE = 5MB,
   MAXSIZE = 25MB,
   FILEGROWTH = 5MB
)
GO

（3）创建顾客表tb_SelCustomer。

use db_MyDemo;
GO
CREATE TABLE tb_SelCustomer
(
   ID INT IDENTITY(1,1) PRIMARY KEY, /*ID,主键*/
   Name varchar(20) NOT NULL, /*姓名*/
   Sex char(1) default('0'), /*性别：0为男，1为女，默认为0*/
   CustomerType char(1) default('0'), /*客户类型：0为普通用户，1为VIP用户，默认为0*/
   Phone varchar(12), /*联系电话*/
   Email varchar(50), /*电子邮件*/
   ContactAddress varchar(200), /*联系地址*/
   Lat float, /*所在位置维度，用于在地图显示*/
   Lng float, /*所在位置经度，用于在地图显示*/
   Postalcode varchar(10), /*邮政编码*/
   Remark varchar(50) /*备注*/
)

 好了，恭喜你！终于把准备工作做好了。下面，让我们一起来揭开Command对象的面纱！

2. 什么是Command对象？

      我们知道ADO.NET最主要的目的对外部数据源提供一致的访问。而访问数据源数据，就少不了增删查改等操作。尽管Connection对象已经我们连接好了外部数据源，但它却忠于职守，并不提供对外部数据源的任何操作。就在纠结万分的时刻，Command对象诞生了。它封装了所有对外部数据源的操作（包括增、删、查、改等SQL语句与存储过程），并在执行完成后返回合适的结果。与Connection对象一样，对于不同的数据源，ADO.NET提供了不同的Command对象。具体来说，可分为以下Command对象。

不管是哪种Command对象，它都继承于DBCommand类。与DBConnection类一样，DBCommand类也是抽象基类，不能被实例化，并期待派生类（对应于特定.NET数据提供程序的Command类）来实现方法。 DBCommand类定义了完善的健全的数据库操作的基本方法和基本属性，它的结构如下：

public abstract class DbCommand : Component, 
    IDbCommand, IDisposable

从上面我们可以知道，它继承了Component类以及IDbCommand接口和IDisposable接口。

3. 必须掌握的几个属性

 CommandText: 获取或设置对数据源执行的文本命令。默认值为空字符串。

 CommandType: 命令类型，指示或指定如何解释CommandText属性。CommandType属性的值是一个枚举类型，定义结构如下：

public enum CommandType    
{      Text = 1,    //SQL 文本命令。（默认。）          
        StoredProcedure = 4,    // 存储过程的名称。          
        TableDirect = 512    //表的名称。  
}

需要特别注意的是，将CommandType 设置为 StoredProcedure 时，应将 CommandText 属性设置为存储过程的名称。 当调用 Execute 方法之一时，该命令将执行此存储过程。

Connection: 设置或获取与数据源的连接。

Parameters: 绑定SQL语句或存储过程的参数。参数化查询中不可或缺的对象，非常重要。

Tranction: 获取或设置在其中执行 .NET Framework 数据提供程序的 Command 对象的事务。

4. 必须掌握的几个方法

 ExecuteNonQuery: 执行不返回数据行的操作，并返回一个int类型的数据。

 注意：对于 UPDATE、INSERT 和 DELETE 语句，返回值为该命令所影响的行数。 对于其他所有类型的语句，返回值 为 -1。

 ExecuteReader: 执行查询，并返回一个 DataReader 对象。
 ExecuteScalar: 执行查询，并返回查询结果集中第一行的第一列（object类型）。如果找不到结果集中第一行的第一列，则返回 null 引用。

5. 如何创建Command对象？

      在创建Command对象之前，你需要明确两件事情：（1）你要执行什么样的操作？（2）你要对哪个数据源进行操作？明白这两件事情，一切都好办了。我们可用通过string字符串来构造一条SQL语句，也可以通过Connection对象指定连接的数据源。那么我们如何将这些信息交给Command对象呢？一般来说，有两种方法：

（1）通过构造函数。代码如下：

string strSQL = "Select * from tb_SelCustomer";
SqlCommand cmd = new SqlCommand(strSQL, conn);

（2）通过Command对象的属性。代码如下：

SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = strSQL;

提示：上面两个实例是相对于SQL Server来说的，如果你访问其他数据源，应当选择其他的Command对象。具体参照 #2 什么是Command对象 中的表格。

6. 选择合适的执行命令

      Command对象提供了丰富的执行命令操作，具体方法可参考 #4 必须掌握的几个方法 。凡是有利有弊，Comandante对象既然提供多种执行命令，我们在实际开发中就要有所取舍，选择合适的执行命令。其实，用户对数据源的操作不外乎CRUD-S（Create、Update、Delete、Select）操作。下面我将探讨如何在不同的场景选择合适的执行命令。

（1）场景一：执行CRUD操作，不返回数据行，返回影响的行数（可选）

      当我们对数据表的行（记录）进行增加，删除，更新操作或者处理数据定义语句（比如用Create Table来创建表结构）时，实际上数据库是不返回数据行的，仅仅返回一个包含影响行数信息的整数。一般地，在执行非查询操作时，我们需要调用ExcuteNonQuery方法。还是，先看一个实例吧！我们在tb_SelCustomer表中插入一行记录，代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Data;//必须引入
using System.Data.SqlClient;//必须引入

namespace Command
{
    class Program
    {
        static void Main(string[] args)
        {
            string connSQL = @"Data Source=.\SQLEXPRESS; Initial Catalog=db_MyDemo; Integrated Security=SSPI";//构造连接字符串
            SqlConnectionStringBuilder connStr = new SqlConnectionStringBuilder(connSQL);

            using(SqlConnection conn = new SqlConnection(connStr.ConnectionString))
            {
                //拼接SQL语句
                  StringBuilder strSQL = new StringBuilder();
                strSQL.Append("insert into tb_SelCustomer ");
                strSQL.Append("values(");
                strSQL.Append("'liuhao','0','0','13822223333','liuhaorain@163.com','广东省深圳市宝安区',12.234556,34.222234,'422900','备注信息')");

                Console.WriteLine("Output SQL:\n{0}",strSQL.ToString());

                //创建Command对象
                  SqlCommand cmd = new SqlCommand();
                cmd.Connection = conn;
                cmd.CommandType = CommandType.Text;
                cmd.CommandText = strSQL.ToString();

                try
                {
                    conn.Open();//一定要注意打开连接

                       int rows = cmd.ExecuteNonQuery();//执行命令
                       Console.WriteLine("\nResult: {0}行受影响",rows);
                }
                catch(Exception ex)
                {
                    Console.WriteLine("\nError：\n{0}", ex.Message);
                }
            }

            Console.Read();
        }
    }
}

 运行后，输出结果如下：

从上面输出信息我们可以看到，已经成功的添加一行数据。

（2）场景二：执行Select操作，返回多个数据

      当我们通过执行Select操作返回一行或多行数据时，这时候ExcuteNonQuery就需要休息了。不过也别慌，话说Command对象手下猛将如云，处理这种事情就需要请ExcuteReader方法上场了。ExcuteReader方法返回一个DataReader对象。DataReader是一个快速的，轻量级，只读的遍历访问每一行数据的数据流。使用DataReader时，需要注意以下几点：

• DataReader一次遍历一行数据，并返回一个包含列名字集合。

• 第一次调用Read()方法获取第一行数据，并将游标指向下一行数据。当再次调用该方法时候，将读取下一行数据。

• 当检测到不再有数据行时，Read()方法将返回false。

• 通过HasRows属性，我们知道查询结果中是否有数据行。

• 当我们使用完DataReader时，一定要注意关闭。SQL Server默认只允许打开一个DataReader。

好吧，还是先看一个简单的例子吧。查询出tb_SelCustomer表中所有的数据。代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Data;
using System.Data.SqlClient;

namespace Command2
{
    class Program
    {
        static void Main(string[] args)
        {
            //构造连接字符串
              SqlConnectionStringBuilder strConn = new SqlConnectionStringBuilder();
            strConn.DataSource = @"(local)\SQLEXPRESS";
            strConn.InitialCatalog = "db_MyDemo";
            strConn.IntegratedSecurity = true;

            using (SqlConnection conn = new SqlConnection(strConn.ConnectionString))
            {
                string strSQL = "select * from tb_SelCustomer";
                SqlCommand cmd = new SqlCommand(strSQL, conn);//使用构造函数方式创建Command对象

                   conn.Open();//记得打开连接

                try
                {
                    SqlDataReader reader = cmd.ExecuteReader();//执行ExecuteReader

                    if (reader != null && reader.HasRows)
                    {
                        int rows = 0;//记录行数
                            Console.WriteLine("**********Records of tb_SelCustomer**********\n");
                        while (reader.Read())
                        {
                            for (int i = 0; i < reader.FieldCount; ++i)
                            {
                                Console.WriteLine("{0}:{1}", reader.GetName(i), reader.GetValue(i));
                            }
                            ++rows;
                        }
                        Console.WriteLine("\n共{0}行记录", rows);
                    }
                    reader.Close();//关闭DataReader
                }
                catch (Exception ex)
                {
                    Console.WriteLine("\nError:\n{0}", ex.Message);
                }
            }

            Console.Read();
        }
    }
}

执行上面代码后，我们可以看到在 场景（一） 中添加的数据。结果下图所示。

（3）场景三：执行Select操作，返回单个值

      上面两个场景相信大家都十分熟悉了。但是，当我们在操作数据库时仅仅只需要返回一个值（比如返回行数），那该怎么办呢？在此，我不得不承认Command对象确实人才济济，ExcuteScalar方法就是处理单个数据最优秀的人才。ExcuteScalar返回一个System.Object类型的数据，因此我们在获取数据时需要进行强制类型转换。当没有数据时，ExcuteScalar方法返回System.DBNull。理论在于实践，我们还是先看看一个实例吧！获取tb_SelCustomer中的行数。代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Data;
using System.Data.SqlClient;

namespace Command3
{
    class Program
    {
        static void Main(string[] args)
        {
            string connSQL = @"Data Source=.\SQLEXPRESS; Initial Catalog=db_MyDemo; Integrated Security=SSPI";

using (SqlConnection conn = new SqlConnection(connSQL))
{
string strSQL = "select count(*) from tb_SelCustomer";
SqlCommand cmd = new SqlCommand(strSQL, conn);//创建Command对象 

try
{
conn.Open();//一定要注意打开连接 
int rows = (int)cmd.ExecuteScalar();//执行命令 
Console.WriteLine("执行ExcuteScalar方法：共{0}行记录", rows);
}
catch (Exception ex)
{
Console.WriteLine("\nError：\n{0}", ex.Message);
}
}

            Console.Read();
        }
    }
}

 输出结果如下：

7. 总结

       终于松一口气了，历时一个多星期，总算将Command对象一些最最基础但又重要的知识点讲完了。也不知道大家对Command对象了解了多少，不过我敢肯定的是，只要你认认真真看完本篇文章，至少对Command对象的一些基础知识有印象了。归根结底，Command对象就是一个载体。它向数据库传达了用户的操作信息，而数据库则通过Command对象向用户返回处理结果。在下一篇文章中，我将讲解Command对象的一些高级应用，希望大家能继续关注和推荐。