Winform开发之SqlCommand常用属性和方法
SqlCommand类表示要对 SQL Server 数据库执行的一个 Transact-SQL 语句或存储过程，有若干个属性和若干个方法，具体的各类方法使用可以从msdn上找到。
这里介绍几个常用东东
一、属性
CommandText 获取或设置要对数据源执行的 Transact-SQL 语句、表名或存储过程。
CommandTimeout 获取或设置在终止执行命令的尝试并生成错误之前的等待时间。
CommandType 获取或设置一个值，该值指示释 CommandText 是SQL语句，存储过程还是表操作。
Connection 获取或设置 SqlCommand 的此实例使用的 SqlConnection。
Parameters 获取 SqlParameterCollection。
Transaction 获取或设置将在其中执行 SqlCommand 的 SqlTransaction。
static void Main(string[] args) { string str = "server=.;database=JunTest;uid=sa;pwd=123"; SqlConnection conn = new SqlConnection(str); SqlCommand cmd = conn.CreateCommand(); cmd.CommandText = "Update Person Set Name = 'Ado.net修改' WHERE Id = @Id"; //设置操作语句 //看看默认的发生错误等待时间(秒) Console.WriteLine(cmd.CommandTimeout); //30 //指明CommandText是SQL语句，存储过程还是表操作。枚举类型，转到定义可看 Console.WriteLine(cmd.CommandType); //输出 Text 表示这是一条SQL语句 cmd.CommandText=CommandType.StoredProcedure/CommandType.Text //SqlCommand的SqlConnection实例对象 Console.WriteLine(cmd.Connection.ConnectionString); //"server=.;database=JunTest;uid=sa;pwd=123"; //设置参数值 cmd.Parameters.Add("@Id", SqlDbType.Int); cmd.Parameters["@Id"].Value = 1; Console.WriteLine(cmd.Parameters["@Id"].Value); //输出1 conn.Open(); conn.Close(); Console.ReadKey(); }
二、方法
1、SqlCommand.ExecuteNonQuery 方法
对数据库的增删改都用这个操作，只是里面调用的sql语句和存储过程不同
static void Main(string[] args) { string str = "server=.;database=JunTest;uid=sa;pwd=123;"; SqlConnection conn = new SqlConnection(str); //创建连接 SqlCommand cmd = conn.CreateCommand(); //创建命令 cmd.CommandText = "Update Person Set PersonName = 'Ado.net修改' WHERE PersonId = @Id"; //设置操作语句 cmd.Parameters.Add("@Id", SqlDbType.Int); //添加参数,说明类型 cmd.Parameters["@Id"].Value = 1; //设置参数值 conn.Open(); //打开连接 int i = cmd.ExecuteNonQuery(); //执行命令，ExecuteNonQuery由名称看出，只能用于非查询语句 conn.Close(); //关闭连接 Console.WriteLine(i); //输出影响行数 Console.ReadKey(); }
2、ExecuteScalar()
创建一个 SqlCommand，然后使用 ExecuteScalar 执行它。 向该示例传递两个字符串，一个字符串表示要插入到表中的新值，另一个字符串用于连接至数据源。 如果已插入新行，则此函数会返回新的“Identity”列值，如果失败，则返回 0。
static public int AddProductCategory(string newName, string connString) { Int32 newProdID = 0; string sql = "INSERT INTO Production.ProductCategory (Name) VALUES (@Name); " + "SELECT CAST(scope_identity() AS int)"; using (SqlConnection conn = new SqlConnection(connString)) { SqlCommand cmd = new SqlCommand(sql, conn); cmd.Parameters.Add("@Name", SqlDbType.VarChar); cmd.Parameters["@name"].Value = newName; try { conn.Open(); newProdID = (Int32)cmd.ExecuteScalar(); } catch (Exception ex) { Console.WriteLine(ex.Message); } } return (int)newProdID; }
3、ExecuteReader()
static void Main(string[] args) { string str = "server=.;database=JunTest;uid=sa;pwd=123;"; SqlConnection conn = new SqlConnection(str); //创建连接 SqlCommand cmd = conn.CreateCommand(); //创建命令 cmd.CommandText = "SELECT * FROM Person"; //设置操作语句 conn.Open(); //打开连接 //SqlDataReader读取数据 using (SqlDataReader reader = cmd.ExecuteReader()) { while (reader.Read()) { Console.WriteLine(reader[0] + ":" + reader[1]); //输出当前行的第一列，第二列数据 } } cmd.CommandText = "SELECT Count(*) FROM Person"; object obj = cmd.ExecuteScalar(); //仅查询第一行第一列 Console.WriteLine((int)obj); conn.Close(); //关闭连接 Console.ReadKey(); }
4、ExecuteXmlReader() 返回System.XmlReader实例，用于读取SQLServer中的XML字段的值
数据库字段存的就是xml
<Article> <author age="30">张三</author> <length>12000</length> <price>42</price> </Article>
static void Main(string[] args) { string str = "server=.;database=JunTest;uid=sa;pwd=123;"; SqlConnection conn = new SqlConnection(str); //创建连接 SqlCommand cmd = conn.CreateCommand(); //创建命令 cmd.CommandText = "SELECT * FROM Person"; //设置操作语句 conn.Open(); //打开连接 cmd.CommandText = "SELECT Top 1 ArticleInfo FROM Article"; //查询XML字段 using (XmlReader reader = cmd.ExecuteXmlReader()) //由Command实例返回XmlReader的实例 { while (reader.Read()) { if (reader.Name == "author") { Console.WriteLine(reader.ReadInnerXml()); //输出张三 } } } conn.Close(); Console.ReadKey(); }
还有就是以上这些方法的异步版本，本处仅以以下两个方法示例:
5、BeginExecuteNonQuery() 异步版ExecuteNonQuery()
6、EndExecuteNonQuery() 异步版ExecuteNonQuery()
class Program { static void Main(string[] args) { string str = "server=.;database=JunTest;uid=sa;pwd=123;Asynchronous Processing=true"; SqlConnection conn = new SqlConnection(str); //创建连接 SqlCommand cmd = conn.CreateCommand(); //创建命令 cmd.CommandText = "INSERT INTO Person VALUES(11,'郭嘉')"; //设置操作语句 conn.Open(); //打开连接 cmd.BeginExecuteNonQuery(BeginCallback, cmd); //异步执行语句 Console.WriteLine("不管你执没执行完，我继续做我的事!"); Console.ReadKey(); } public static void BeginCallback(IAsyncResult result) { Console.WriteLine("正在执行SQL命令!"); SqlCommand cmd = result.AsyncState as SqlCommand; //获得异步传入的参数 Console.WriteLine("成功执行命令：" + cmd.CommandText); Console.WriteLine("本次执行影响行数为：" + cmd.EndExecuteNonQuery(result)); Console.WriteLine("关闭连接!"); cmd.Connection.Close(); //正式关闭连接 } }
本文一部分来自msdn，一部分来自逆心的博客
