SqlCommand.ExecuteNonQuery

对连接执行 Transact-SQL 语句并返回受影响的行数。

 

您可以使用 ExecuteNonQuery 来执行目录操作（例如查询数据库的结构或创建诸如表等的数据库对象），或通过执行 UPDATE、INSERT 或 DELETE 语句，在不使用 DataSet 的情况下更改数据库中的数据。

虽然 ExecuteNonQuery 不返回任何行，但映射到参数的任何输出参数或返回值都会用数据进行填充。

对于 UPDATE、INSERT 和 DELETE 语句，返回值为该命令所影响的行数。如果正在执行插入或更新操作的表上存在触发器，则返回值包括受插入或更新操作影响的行数以及受一个或多个触发器影响的行数。对于所有其他类型的语句，返回值为 -1。如果发生回滚，返回值也为 -1。

示例
--------------------------------------------------------------------------------

下面的示例创建一个 SqlCommand，然后使用 ExecuteNonQuery 执行它。给该示例传递两个字符串：一个字符串是 Transact-SQL 语句（如 UPDATE、INSERT 或 DELETE），另一个字符串用于连接数据源。

private static void CreateCommand(string queryString,

    string connectionString)

{

    using (SqlConnection connection = new SqlConnection(

               connectionString))

    {

        SqlCommand command = new SqlCommand(queryString, connection);

        command.Connection.Open();

        command.ExecuteNonQuery();

    }

}