Command
- 概述
在 System.Data.SqlClient 命名空间下，对应的 Command 类为 SqlCommand，在创建 SqlCommand 实例前必须已经创建了与数据库的连接。
SqlCommand 类中常用的构造方法如下表所示:
| 构造方法 | 说明 |
|---|---|
| SqlCommand() | 无参构造方法 |
| SqlCommand(string commandText,SqlConnection conn) | 带参的构造方法，第 1 个参数是要执行的 SQL 语句，第 2 个参数是数据库的连接对象 |
对数据库中对象的操作不仅包括对数据表的操作，还包括对数据库、视图、存储过程等数据库对象的操作，接下来主要介绍的是对数据表和存储过程的操作。
在对不同数据库对象进行操作时，SqlCommand 类提供了不同的属性和方法，常用的属性和方法如下表所示:
| 属性或方法 | 说明 |
|---|---|
| CommandText | 属性，Command 对象中要执行的 SQL 语句 |
| Connection | 属性，获取或设置数据库的连接对象 |
| CommandType | 属性，获取或设置命令类型 |
| Parameters | 属性，设置 Command 对象中 SQL 语句的参数 |
| ExecuteReader() | 方法，获取执行查询语句的结果 |
| ExecuteScalar() | 方法，返回查询结果中第 1 行第 1 列的值 |
| ExecuteNonQuery() | 方法，执行对数据表的增加、删除、修改操作,返回影响的行数 |
- 使用Command类操作数据库
Command 类中提供了 3 种命令类型，分别是 Text、TableDirect 以及 StoredProcedure，默认情况下是 Text。
所谓 Text 类型是指使用 SQL 语句的形式，包括增加、删除、修改以及查询的SQL语句。
StoredProcedure 用于执行存储过程；TableDirect 仅在 OLE DB 驱动程序中有效。
在使用 Command 类操作数据库时需要通过以下步骤完成。
- 创建SqlCommand类的实例
创建 SqlCommand 类的实例分两种情况，一种是命令类型为 Text 的，一种是命令类型为 StoredProcedure 的。
命令类型为 Text
SqlCommand SqlCommand 类的实例名 = new SqlCommand( SQL 语句 , 数据库连接类的实例 );
其中：
- SQL 语句：指该 SqlCommand 类的实例要执行的 SQL 语句。
- 数据库连接类的实例：指使用 SqlConnection 类创建的实例，通常数据库连接类的实例处于打开的状态。
命令类型为 StoredProcedure
SqlCommand SqlCommand 类的实例名 = new SqlCommand( 存储过程名称 , 数据库连接类的实例 );
需要注意的是，存储过程必须是当前数据库实例中的存储过程，并且在调用带参数的存储过程时，还需要在 SqlCommand 类的实例中添加对应的存储过程参数。
为存储过程添加参数，需要使用 SqlCommand 类实例的 Parameters 属性来设置，具体的代码如下。
SqlCommand 类实例 .Parameters.Add( 参数名 , 参数值 );
- 执行对数据表的操作
在执行对数据表的操作时通常分为两种情况，一种是执行非查询 SQL 语句的操作，即增加、修改、删除的操作，一种是执行查询 SQL 语句的操作。
执行非查询 SQL 语句的操作
在执行非查询 SQL 语句时并不需要返回表中的数据，直接使用 SqlCommand 类的 ExecuteNonQuery 方法即可，该方法的返回值是一个整数，用于返回 SqlCommand 类在执行 SQL 语句后，对表中数据影响的行数。
当该方法的返回值为 -1 时，代表 SQL 语句执行失败，当该方法的返回值为 0 时，代表 SQL 语句对当前数据表中的数据没有影响。
例如 要删除学号为 1100 的学生的信息，而表中不存在该学号的学生的信息，SQL语句可以正常执行，但对表中的影响行数是 0。
具体的代码如下:
SqlCommand 类的实例 .ExecuteNonQuery();
需要注意的是，如果执行的 SQL 语句在数据库中执行错误，则会产生异常，因此该部分需要进行异常处理。
执行查询语句的操作
在执行查询语句时通常需要返回查询结果，SqlCommand 类中提供的 ExecuteReader 方法在执行查询 SQL 语句后，会返回一个 SqlDataReader 类型的值，通过遍历 SqlDataReader 类中的结果即可得到返回值。
具体的代码如下:
SqlDataReader dr = SqlCommand 类的实例 .ExecuteReader();
此外，如果在执行查询语句后并不需要返回所有的查询结果，而仅需要返回一个值，例如查询表中的记录行数，这时可以使用 ExecuteScalar 方法。具体的代码如下:
int returnvalue = SqlCommand 类的实例 .ExecuteScalar();
下面通过实例来演示 SqlCommand 类的使用:
- 先创建数据库School，再创建表Student:
CREATE TABLE [dbo].[Student] (
[Id] INT IDENTITY (1, 1) NOT NULL,
[Name] VARCHAR (30) NOT NULL,
[Age] INT NULL,
[EnrollmentDate] DATE NULL,
PRIMARY KEY CLUSTERED ([Id] ASC)
);
这里如果使用visual studio localdb时，插入中文会出现乱码，解决方法可以参考这篇文章：
https://blog.csdn.net/xingkongtianyuzhao/article/details/103944280
- 下面是使用SqlCmd执行插入命令的示例：
这里使用了参数化查询SqlParameter，防止了sql注入
private void btnAddStudent_Click(object sender, EventArgs e)
{
string stuName = txtUserName.Text.Trim();
int stuAge = int.Parse(txtAge.Text.Trim());
DateTime stuEnrollMentDate = dtpEnrollmentDate.Value;
string strConn = Properties.Settings.Default.SchoolConn;
using (SqlConnection conn = new SqlConnection(strConn))
{
try
{
conn.Open();
string strSql = "insert into student(name,age,enrollmentdate) values(@name,@age,@enrollmentdate);";
SqlCommand cmd = new SqlCommand(strSql, conn);
cmd.Parameters.AddWithValue("@name", stuName);
cmd.Parameters.AddWithValue("@age", stuAge);
cmd.Parameters.AddWithValue("@enrollmentdate", stuEnrollMentDate);
int result = cmd.ExecuteNonQuery();
if (result != -1)
{
MessageBox.Show("注册成功!");
}
else
{
MessageBox.Show("注册失败!");
}
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
- 下面是使用SqlCmd执行查询命令的示例：
private void btnSearchStudent_Click(object sender, EventArgs e)
{
string strName = txtStudentName.Text.Trim();
string strConn = Properties.Settings.Default.SchoolConn;
using (SqlConnection conn = new SqlConnection(strConn))
{
try
{
string strSql = "select * from student where name=@name";
SqlCommand cmd = new SqlCommand(strSql, conn);
cmd.Parameters.AddWithValue("@name", strName);
conn.Open();
var reader = cmd.ExecuteReader();
//两种方式查询
while (reader.Read())
{
MessageBox.Show("Id: " + reader.GetInt32(0).ToString());
MessageBox.Show("姓名: " + reader.GetString(1).ToString());
MessageBox.Show("年龄: " + reader.GetInt32(2).ToString());
MessageBox.Show("入学日期: " + reader.GetDateTime(3).ToString("yyyy-MM-dd"));
string result = "Id: " + reader[0] + "姓名：" + reader[1];
MessageBox.Show(result);
}
reader.Close();
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
** 注意ExecuteScalar,ExecuteNoQuery,ExecuteReader的区别 **
- ExecuteNonQuery()：执行命令对象的SQL语句，返回一个int类型变量，如果SQL语句是对数据库的记录进行操作（如记录的增加、删除和更新），那么方法将返回操作所影响的记录条数。
- ExecuteScalar()：执行命令对象的SQL语句，如果SQL语句是SELECT查询，则仅仅返回查询结果集中的第1行第1列，而忽略其他的行 和列。该方法所返回的结果为object类型，在使用之前必须强制转换为所需的类型。如果SQL语句不是SELECT查询，则返回结果没有任何作用。
- ExecuteReader()：执行命令对象的SQL语句，在ADO.NET中，就是DataReader 对象的ExecuteReader()方法来进行数据的列出，并且我们用这个ExecuteReader()方法来显示数据是最快的一种方法，只可以一条一条向前读，不能返回。数据连接关闭，reader数据消失。
** 记忆：**
ExecuteNonQuery:Query是查询的意思，NonQuery就是不用于查询，所以ExecuteNonQuery 除了查询，可以执行增删改语句;
ExecuteScalar: Scalar是游标意思，可以想象成钓鱼的浮标，是用来钓数据的，一般用于查询，而且钓鱼一般一条一条掉，所以只返回第一行第一列的数据；
ExecuteReader: 阅读数据，想象成图书，从前往后翻页，但是它翻脸不认人，不能从后往前翻页，而且翻脸速度特别快(查询快);
Command要记住防止SQL注入，最好用参数化查询，就像钓鱼的鱼饵，不同的鱼得用专用鱼饵，投其所好，防止调上水母啥的,鱼饵要放在SqlParameter里面。
上一节把Command比喻为指挥官，指挥官得知道武器库的地址，所以初始化的时候要给他，SqlConnection;还有指挥命令，Command指挥战斗的两种形式(执行命令)：嘴喊(Text),简单直接;录音(StoredProcedure):步骤太多，嘴喊类,录下来，按个按钮就播放,所以任命指挥官需要两个要素:执行命令的形式和数据库地址。你记住了吗？？？