用DataTable传参数给SQL Server存储过程其实挺方便的，怎么弄呢？

主要综合自知乎、博客园、CSDN等技术社区的相关讨论和微软官方文档的说明）

说起来,用DataTable给SQL Server存储过程传参，这个技巧在处理需要一次性传入多条数据的场景时，确实非常方便，想象一下，你有一个订单系统，用户在前端页面勾选了十件商品，点击“批量下单”，如果没有这个办法，你可能需要循环十次，调用十次存储过程，或者拼凑一个长长的字符串传给数据库，既麻烦又容易出错，而用DataTable，你可以把这十件商品的信息打包成一个“表格”，一次性扔给存储过程，让数据库自己去处理，效率和简洁度都大大提升。

具体怎么“弄”呢？整个过程可以分为三大步：第一步是在SQL Server里创建能接收“表格”的存储过程；第二步是在你的应用程序代码里（比如C#）构造一个结构匹配的DataTable；第三步就是把DataTable作为参数传给数据库并执行存储过程，下面我们一步步拆开说。

第一步：在数据库里准备一个“接待”DataTable的存储过程

关键点在于,SQL Server提供了一种特殊的参数类型，叫做表值参数，你得先在数据库里定义一个用户定义表类型，就像你先设计好一张表格的模板一样，你的存储过程就可以使用这个模板类型来声明参数了。

根据博客园和CSDN上许多开发者的分享,具体的SQL脚本大概长这样：

-- 1. 创建一个我们自定义的‘表格模板’，这里假设我们要批量传入了商品ID和购买数量。
CREATE TYPE dbo.ProductList AS TABLE
(
    ProductID INT NOT NULL,
    Quantity INT NOT NULL
);
GO
-- 2. 创建存储过程，它的参数类型就是我们上面定义的‘表格模板’。
CREATE PROCEDURE sp_CreateBulkOrder
    @CustomerID INT,
    @Items dbo.ProductList READONLY  -- 注意这里，类型是dbo.ProductList，并且是只读的。
AS
BEGIN
    -- 在这个存储过程内部，你可以像操作普通表一样操作这个@Items参数。
    -- 直接把它和商品表关联，插入到订单明细表中。
    INSERT INTO OrderDetails (OrderID, ProductID, Quantity)
    SELECT @CustomerID, ProductID, Quantity FROM @Items;
    -- ... 其他业务逻辑
END
GO

这里有个很重要的细节,就是参数后面必须加上READONLY关键字，这意味着在存储过程里，你只能查询这个表值参数，不能对它进行增删改操作，这是SQL Server的规定。

第二步：在C#代码里“捏”一个一模一样的DataTable

轮到你的应用程序干活了,你需要用代码构造一个DataTable，它的“列”必须和你在SQL Server里定义的那个表类型（dbo.ProductList）的结构完全对应。

根据知乎上一些高赞回答的示例,C#代码通常这样写：

// 新建一个DataTable，并定义它的列结构
DataTable orderItemsTable = new DataTable();
orderItemsTable.Columns.Add("ProductID", typeof(int));   // 列名和数据类型必须和数据库里的类型定义匹配
orderItemsTable.Columns.Add("Quantity", typeof(int));
// 往里添加行数据，每一行就代表一件要购买的商品。
// 这里模拟用户勾选了两件商品
orderItemsTable.Rows.Add(101, 2);  // 商品ID为101，购买2件
orderItemsTable.Rows.Add(205, 1);  // 商品ID为205，购买1件
// ... 可以继续添加更多行

这一步就像是在代码里用乐高积木,搭了一个迷你的内存表格。

第三步：把DataTable作为参数传给存储过程

这是最后一步,也是最关键的一步，你需要使用ADO.NET（就是SqlConnection, SqlCommand这些对象）来执行调用，这里的关键是，要创建一个特殊的SqlParameter，并将它的SqlDbType属性设置为Structured，然后把我们造好的DataTable赋值给它。

综合微软官方文档和社区教程,代码实现如下：

// 假设你已经有了数据库连接字符串
string connectionString = "你的数据库连接字符串";
using (SqlConnection connection = new SqlConnection(connectionString))
{
    connection.Open();
    using (SqlCommand command = new SqlCommand("sp_CreateBulkOrder", connection))
    {
        // 指定命令类型为存储过程
        command.CommandType = CommandType.StoredProcedure;
        // 添加普通的标量参数，比如客户ID
        command.Parameters.AddWithValue("@CustomerID", 12345);
        // 添加最重要的表值参数！
        SqlParameter tvpParam = command.Parameters.AddWithValue("@Items", orderItemsTable);
        tvpParam.SqlDbType = SqlDbType.Structured; // 必须设置为Structured类型
        // 有时候可能需要指定类型名称，但如果存储过程参数类型明确，通常可以省略
        // tvpParam.TypeName = "dbo.ProductList";
        // 执行命令
        command.ExecuteNonQuery();
    }
}

当你调用ExecuteNonQuery()后，你内存中的那个orderItemsTable就会被整体发送到SQL Server，并作为参数@Items传递给存储过程sp_CreateBulkOrder，存储过程接着就会像处理普通表一样，处理你传过来的这批数据。

总结一下好处和注意事项

• 好处：正如很多开发者所称赞的，这种方法避免了多次数据库往返，性能提升显著；代码逻辑清晰，将批量操作封装在一次调用中；比拼接字符串更安全，避免了SQL注入风险。
• 注意事项：表值参数是只读的；确保C#中DataTable的结构（列名、数据类型、顺序）与SQL Server中定义的用户表类型完全一致；对于非常大的数据量（比如数十万行），可能需要考虑其他批量操作方式，但对于大多数业务场景，表值参数已经非常高效和实用了。

希望这个直接的解释能帮助你理解并上手这个“方便”的技巧。