ADO.NET 之 三 yz

三、操作篇（1）

1.构造函数

// 1.
SqlCommand cmd = new SqlCommand(); //默认构造函数
/*
   相关的默认值为以下:
   CommandText : 空字符串
  CommandTimeout : 30s
   CommandType : CommandType.Text
   Connection : NULL
*/

//2.
SqlCommand cmd = new SqlCommand( 
     "SELECT * FROM NORTHWND"         //T-SQL语句
  );

//3.
using(SqlConnection con = new SqlConnection("...") )
{
     SqlCommand cmd = new SqlCommand(
                   "SELECT * FROM NORTHWND",   //T-SQL语句
             con                                           //数据库连接实例
}

//4.
using(SqlConnection con = new SqlConnection("...") )
{
     SqlTransaction tr = con.BeginTransaction("NorthwndTransaction"); //创建事务 后面章节将会介绍
     SqlCommand cmd = new SqlCommand(
                   "SELECT * FROM NORTHWND", //T-SQL语句
                   con,                                        //数据库连接实例
                   tr                                            //事务实例
    );
}

2.下面我们将介绍经常使用的属性和方法

2.1 设置或获取数据库连接实例

using( SqlConnection con = new SqlConnection("...") )
{
     SqlCommand cmd = new SqlCommand();
     cmd.Connection = con;    //设置有关的数据库连接实例
}

2.2 设置或获取超时时间

using( SqlConnection con = new SqlConnection("...") )
{
     SqlCommand cmd = new SqlCommand();
     cmd.CommandTimeout = 45;  //设置超时时间为45s
}

//注意: 0 表示无限等待
//在异步中忽略该参数

2.3 获取或设置一个值，只是CommandText的解释

using( SqlConnection con = new SqlConenction())
{
      SqlCommand cmd = new SqlCommand();
      cmd.CommandType = CommandType.StoredProcedure;//设置如何解释 CommandType 的解释
}
//默认为:CommandType.Text

2.4 获取或设置需要执行的T-SQL语句、表明或存储过程

using( SqlConnection con = new SqlConnection() )
{
     SqlCommand cmd = new SqlCommand();
     cmd.CommandText = "SELECT * FROM NORTHWND";//设置需要指定 T-SQL 语句、表名或存储过程
}

2.5 设置或获取 T-SQL 语句或存储过程的参数

using (SqlConnection connection = new SqlConnection("..."))
      {
          SqlCommand cmd = new SqlCommand();
          cmd.Connection = con;
          cmd.CommandText = "UPDATE Sales.Store SET Demographics = @demographics "
          + "WHERE CustomerID = @ID;";
          command.Parameters.Add("@ID", SqlDbType.Int);//增加一个参数
          command.Parameters["@ID"].Value = customerID; //设置改参数的值
          command.Parameters.AddWithValue("@demographics", demoXml);//增加并设置改参数的值
      }

2.6 尝试取消 SqlCommand 的执行

using( SqlConnection con = new SqlConnection("...") )
{
        SqlCommand cmd = new SqlCommand();
4         con.Open();
        cmd.Connection = con;
        cmd.CommandText = "SELECT * FROM NORTHWND";
7         cmd.ExecuteReader();
        cmd.Cancel(); //尝试取消执行
}

2.7 执行 T-SQL 语句并返回受影响的行

using( SqlConnection con = new SqlConnection("...") )
{
     SqlCommand cmd = new SqlCommand();
4      con.Open();
     cmd.Conenction = con;
     cmd.CommandText = "UPDATE NORTHWND SET NAME = 'AD' WHERE ID = 1";
     int rows = cmd.ExecuteNonQuery(); //返回该语句执行后受影响的行数
}

2.8 执行 CommandText 并返回一个 SqlDataReader

using( SqlConnection con = new SqlConenction("..") )
{
     SqlCommand cmd = new SqlCommand();
4      con.Open();
     cmd.Connection = con;
     cmd.CommandText = "SELECT * FROM NORTHWND";
     SqlDataReader reader = cmd.ExecuteReader(); //执行CommandText并返回一个 SqlDataReader 
}

2.9 带参数的 ExecuteReader

using( SqlConnection con = new SqlConnection("...") )
{
    SqlCommand cmd = new SqlCommand();
    con.Open();
    cmd.Conencion = con;
    SqlDataReader reader = cmd.ExecuteReader(CommandBehavior.CloseConnection); //当 reader 关闭时 con 也会关闭
}

该参数可选值如下:

CommandBehavior:

      Default:默认

      SingleResult：查询返回一个结果集

      SchemaOnly：查询只返回列信息

      KeyInfo：此查询返回列和主键信息

      SingleRow：查询应返回一行

     CloseConnection：当关联的 DataReader 关闭时，相关的数据库连接实例也关闭

2.10 返回结果集中的第一行第一列

ExecuteScalar();

上面已经介绍了常用的属性和方法,下面一节将会介绍更高级更深层次的.