表值参数混合使用显式值与用户定义表类型列默认值问题

我正在向存储过程传递表值参数（参考微软官方文档），传入参数使用IEnumerable<SqlDataRecord>实例。
针对其中某一列，我希望部分记录使用SqlDataRecord上显式设置的值，其余记录使用对应用户定义表类型定义的列默认值。
但该混合传值的需求似乎无法实现，尽管SqlMetaData.UserServerDefault属性初看是适配该需求的方案。
我遇到两个异常现象：

• 当设置UserServerDefault=true时，即使已在SqlDataRecord上显式设置了值，系统也始终使用表类型的列默认值
• 我尝试不在所有记录间复用同一个SqlMetaData[]实例、按需调整UserServerDefault取值来解决上述问题，却发现第一条记录的SqlMetaData[]（至少是其中UserServerDefault的取值）会被应用到所有后续记录上。

以下为复现问题的代码示例：

// 自定义表类型包含单个int列'MyInt'，已配置默认值
var recordWithExplicitValue = new SqlDataRecord(new SqlMetaData("MyInt",  SqlDbType.Int, useServerDefault: false, ..));
recordWithExplicitValue.SetValue(ordinal: 0, value: 123);

var recordWithServerDefault = new SqlDataRecord(new SqlMetaData("MyInt",  SqlDbType.Int, useServerDefault: true, ..));

IEnumerable<SqlDataRecord> recordsA = new [] { recordWithExplicitValue, recordWithServerDefault };
IEnumerable<SqlDataRecord> recordsB = new [] { recordWithServerDefault, recordWithExplicitValue };

// 传入recordsA时，TVP实际收到两行：(123), (NULL)
parameters.Add(new SqlParameter("..", recordsA));

// 传入recordsB时，TVP实际收到两行：(DEFAULT), (DEFAULT)
parameters.Add(new SqlParameter("..", recordsB));

我的预期结果是得到(123), (DEFAULT)的两行数据，想确认该需求是否可以实现，以及我观察到的现象是否存在错误。

你观察到的现象完全是SqlClient的设计导致的，不属于代码编写错误。

根因说明 #

SqlClient处理IEnumerable<SqlDataRecord>类型的表值参数时，只会读取枚举序列中第一条SqlDataRecord绑定的SqlMetaData元数据，作为整个TVP的统一结构定义，后续所有记录的元数据配置（包括useServerDefault开关）都会被直接忽略，不产生任何效果。
对应你遇到的现象：

• useServerDefault=true的原生设计就是强制走服务端默认：只要该开关生效，无论你给对应列设置什么值，SqlClient都不会将该列值发送到SQL Server，直接触发服务端默认值填充。
• 传入recordsA时，首条记录元数据为useServerDefault:false，第二条记录的useServerDefault:true被忽略，且你未给第二条记录赋值，因此SqlClient向服务端传输了NULL，最终得到(123), (NULL)的结果。
• 传入recordsB时，首条记录元数据为useServerDefault:true，第二条记录的useServerDefault:false被忽略，因此两条记录都走服务端默认逻辑，最终得到(DEFAULT), (DEFAULT)的结果。

实现方案 #

可根据业务场景选择以下三种方案实现混合传值需求：

• 换用DataTable作为TVP传参载体（改造成本最低）
  DataTable传TVP不存在首行元数据锁死的限制。你只需给对应DataColumn配置默认值，需要走服务端默认的行不给该列显式赋值、保留DBNull即可，需要传显式值的行直接给对应列赋值，SqlClient会正确识别两种状态，分别传值或触发服务端默认填充。
• C#侧预加载默认值统一传参
  如果必须使用IEnumerable<SqlDataRecord>传参，可以提前查询获取目标用户定义表类型对应列的默认值，所有记录统一使用useServerDefault:false的元数据：需要传显式值的记录直接赋值，需要走默认的记录在C#侧将预取的默认值赋给对应列即可。该方案的缺点是如果表类型的默认值发生变更，需要同步更新C#侧的取值逻辑，适合默认值固定不常变动的场景。
• 拆分批次通过临时表中转
  将需要显式传值的记录和需要走默认值的记录拆分为两个独立的IEnumerable<SqlDataRecord>序列，分别匹配对应useServerDefault配置的元数据。不要将两个序列拼接为一个传给TVP参数，可以先创建和TVP结构一致的临时表：显式值的记录直接传入插入临时表，走默认值的记录通过省略对应列的INSERT语句插入临时表，最后基于临时表执行后续存储过程逻辑。

内容的提问来源于stack exchange，提问作者Eske Sparsø