Umbraco Forms预值源渲染异常：Key Column被忽略如何解决？

我之前在Umbraco Forms里用数据库预值源渲染选项列表时，也碰到过这个一模一样的问题！一开始以为是自己配置错了，折腾了半天才找到原因和解决办法，分享给你：

第一步：先检查预值源的基础配置 #

首先确认你在创建数据库预值源时，是不是正确区分了Key Column和Value Column：

• 进入Umbraco后台 → 设置 → 预值源 → 找到你的数据库预值源
• 确保Key Column选的是你想作为input value的字段（比如ID、编码这类唯一标识），Value Column选的是显示给用户看的标签文本
• 有时候不小心会把两者选反，或者误选成同一个字段，这是最常见的低级错误

第二步：自定义字段视图模板（如果配置没问题） #

如果预值源配置完全正确，但渲染还是不对，那就是Umbraco Forms的默认视图模板没有正确区分Key和Value。这时候需要自定义字段的渲染视图：

1. 找到Umbraco Forms的默认字段视图，路径一般是~/Views/Partials/Forms/Fields/RadioList.cshtml（对应你的单选按钮字段）
2. 复制这个文件到同一目录，重命名为CustomRadioList.cshtml（避免后续升级Umbraco时被覆盖）
3. 修改视图里的渲染逻辑，把input的value属性从item.Value改成item.Key，同时保持label文本为item.Value，还要同步修改选中状态的判断条件：

修改后的核心代码示例：

@foreach (var item in Model.PreValues)
{
    <div class="umbraco-forms-radio">
        <input type="radio" 
               id="@(Model.Id)_@item.Id" 
               name="@Model.Id" 
               value="@item.Key" 
               @(Model.IsChecked(item.Key) ? "checked='checked'" : "") />
        <label for="@(Model.Id)_@item.Id">@item.Value</label>
    </div>
}

4. 回到Umbraco后台，编辑你的表单字段，在「外观」选项卡下，把「字段视图」改成你刚才创建的CustomRadioList，保存后刷新表单页面就能看到效果了

额外提醒：版本兼容性 #

如果你用的是比较旧的Umbraco Forms版本，可能存在预值源Key Column不生效的已知bug，这种情况下建议升级到最新的稳定版本，很多这类小问题在新版本里都被修复了。

这样修改后，input的value就会是你设置的Key Column值，标签显示Value Column的文本，表单提交后你也能正确获取到选中项的Key值了。

内容的提问来源于stack exchange，提问作者Gavlar