如何将字典列表绑定到Xamarin.Forms Picker？绑定失败求助

问题背景 #

使用MVVM模式将List<Dictionary<string, string>>类型属性绑定到Picker的ItemsSource时，绑定未生效，无法正常显示选项。

相关代码与数据 #

模型属性

public List<Dictionary<string, string>> Options { get; set; }

API返回JSON

"options": [
    {
        "key": "06/30/2021",
        "value": "06/30/2021"
    },
    {
        "key": "05/31/2021",
        "value": "05/31/2021"
    },
    {
        "key": "04/30/2021",
        "value": "04/30/2021"
    }
]

XAML代码

<controls:BorderlessPicker Grid.ColumnSpan="2" 
                           Title="{Binding DisplayName}" 
                           ItemsSource="{Binding SelectedContent.Attributes.Options}" 
                           ItemDisplayBinding="{Binding Value}" >
</controls:BorderlessPicker>

核心问题分析 #

绑定失效的根源在于：List<Dictionary<string, string>>中的每个元素是Dictionary对象，而非键值对实体。XAML的ItemDisplayBinding="{Binding Value}"试图绑定名为Value的属性，但Dictionary本身没有这个公共属性，它只有通过索引器访问键值的能力，因此绑定无法找到对应值。

解决方案 #

方案1：改用自定义实体类（推荐）

创建对应实体类替换Dictionary，让数据结构更清晰，绑定更可靠：

public class OptionItem
{
    public string Key { get; set; }
    public string Value { get; set; }
}

修改模型属性类型：

public List<OptionItem> Options { get; set; }

此时JSON反序列化会自动映射到OptionItem的属性，原XAML的ItemDisplayBinding="{Binding Value}"可正常工作。

方案2：使用索引器绑定（临时兼容）

如果无法修改模型结构，可通过Dictionary的索引器绑定对应键的值：

<controls:BorderlessPicker Grid.ColumnSpan="2" 
                           Title="{Binding DisplayName}" 
                           ItemsSource="{Binding SelectedContent.Attributes.Options}" 
                           ItemDisplayBinding="{Binding [value]}" >
</controls:BorderlessPicker>

这里[value]对应JSON中每个对象的"value"键，通过索引器获取对应值。

额外排查点 #

除核心问题外，需检查以下常见绑定失效原因：

• 确认ViewModel实现了INotifyPropertyChanged接口，当Options数据更新时触发PropertyChanged事件；
• 检查SelectedContent、Attributes是否不为null，且Attributes.Options已正确加载API返回的数据；
• 验证Picker的DataContext是否正确指向目标ViewModel实例；
• 查看开发工具输出窗口，绑定失败的详细错误信息会在这里打印，帮助定位问题。

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