首先在SQL Server创建用户定义表类型和存储过程,然后在C#中通过DataTable配合SqlDbType.Structured与TypeName传递数据,实现高效批量插入。

在C#中使用存储过程的表值参数(Table-Valued Parameters, TVP),需要在数据库端定义用户自定义表类型,并在存储过程中作为参数接收。C#通过 DataTable 或 DbDataReader 将数据传递给该参数。以下是具体步骤和示例。
1. 在SQL Server中创建用户定义表类型
首先,在数据库中定义一个表类型,作为TVP的基础。示例:
CREATE TYPE dbo.UserListType AS TABLE
(
Id INT,
Name NVARCHAR(50)
);
2. 创建使用TVP的存储过程
编写存储过程,接收表值参数。示例:
CREATE PROCEDURE dbo.InsertUsers
@Users dbo.UserListType READONLY
AS
BEGIN
INSERT INTO Users (Id, Name)
SELECT Id, Name FROM @Users;
END
3. C#代码中传递DataTable作为TVP
在C#中,使用 SqlParameter 并设置其 SqlDbType 为 Structured,同时指定 TypeName 为自定义表类型名。示例代码:
using System; using System.Data; using System.Data.SqlClient;var dataTable = new DataTable(); dataTable.Columns.Add("Id", typeof(int)); dataTable.Columns.Add("Name", typeof(string));
// 添加数据行 dataTable.Rows.Add(1, "Alice"); dataTable.Rows.Add(2, "Bob");
using (var connection = new SqlConnection(connectionString)) { connection.Open(); using (var command = new SqlCommand("InsertUsers", connection)) { command.CommandType = CommandType.StoredProcedure;
var parameter = new SqlParameter("@Users", SqlDbType.Structured) { TypeName = "dbo.UserListType", Value = dataTable }; command.Parameters.Add(parameter); command.ExecuteNonQuery(); }}
4. 注意事项
- TVP 参数必须声明为 READONLY,不能在存储过程中修改。
- C# 中只能传递 DataTable、DbDataReader 或实现了 IEnumerable
的对象。 - Type name 必须与数据库中定义的表类型完全一致(包括 schema)。
- 确保连接字符串具有执行存储过程和插入数据的权限。
基本上就这些。只要数据库类型和C#传入的数据结构匹配,TVP就能高效传递多行数据,避免多次调用。










