C#中如何使用存储过程的表值参数？如何传递？-C#.Net教程-PHP中文网

C#中如何使用存储过程的表值参数？如何传递？

煙雲

发布： 2025-10-15 21:02:01

原创

229人浏览过

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

c#中如何使用存储过程的表值参数？如何传递？

在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的存储过程

编写存储过程，接收表值参数。

示例：

<pre class="brush:php;toolbar:false;">
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 为自定义表类型名。

示例代码：

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

<pre class="brush:php;toolbar:false;">
using System;
using System.Data;
using System.Data.SqlClient;
<p>var dataTable = new DataTable();
dataTable.Columns.Add("Id", typeof(int));
dataTable.Columns.Add("Name", typeof(string));</p><p>// 添加数据行
dataTable.Rows.Add(1, "Alice");
dataTable.Rows.Add(2, "Bob");</p><p>using (var connection = new SqlConnection(connectionString))
{
connection.Open();
using (var command = new SqlCommand("InsertUsers", connection))
{
command.CommandType = CommandType.StoredProcedure;</p><pre class="brush:php;toolbar:false;"><code>    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<SqlDataRecord> 的对象。
Type name 必须与数据库中定义的表类型完全一致（包括 schema）。
确保连接字符串具有执行存储过程和插入数据的权限。

基本上就这些。只要数据库类型和C#传入的数据结构匹配，TVP就能高效传递多行数据，避免多次调用。

以上就是C#中如何使用存储过程的表值参数？如何传递？的详细内容，更多请关注php中文网其它相关文章！