Xamarin.Forms中使用C#将独立HTML内容绑定到多个Label的方法

问题根因 #

1. XAML中使用x:DataType="myNameSpace:MyClass"开启了编译时强类型绑定，该机制仅能识别MyClass中显式定义的公共属性，无法直接解析dynamic类型的运行时字段，因此会抛出找不到属性的错误。
2. 此前定义的label属性仅返回固定字符串，未关联到dynamicObject中的JSON字段，且未在XAML中指定TextType="Html"，即便绑定成功也会直接显示HTML源码而非渲染后的内容。

最高效实现方案 #

优先选择强类型绑定方案，性能最优且适配XAML原生绑定机制，无额外运行时开销：

方案1：JSON反序列化为强类型ViewModel（推荐） #

1. 根据JSON结构定义对应实体类：

namespace myNameSpace;

public class MyClass
{
    // 对应JSON中的label字段，存储HTML字符串
    public string label { get; set; }
    // 对应JSON中的label2字段
    public string label2 { get; set; }
}

2. 将JSON内容直接反序列化为MyClass实例，无需用dynamic接收，再赋值给页面数据上下文：

// System.Text.Json 实现示例，Newtonsoft.Json用法同理
MyClass viewModel = JsonSerializer.Deserialize<MyClass>(jsonString);
this.DataContext = viewModel;

3. 修改XAML代码，新增TextType指定为Html即可：

<Label x:DataType="myNameSpace:MyClass" 
       Text="{Binding label}"
       TextType="Html"/>
<Label x:DataType="myNameSpace:MyClass" 
       Text="{Binding label2}"
       TextType="Html"/>

方案2：JSON结构不固定需保留dynamic的场景 #

如果JSON字段无法提前确定，可在MyClass中封装索引器实现动态字段访问：

namespace myNameSpace;

public class MyClass
{
    // 存储加载后的dynamic JSON对象
    public dynamic DynamicObject { get; set; }

    // 索引器通过字段名读取dynamic内容
    public string this[string fieldName]
    {
        get
        {
            return DynamicObject?[fieldName]?.ToString() ?? string.Empty;
        }
    }
}

XAML中通过索引路径绑定对应字段：

<Label Text="{Binding [label]}" TextType="Html"/>
<Label Text="{Binding [label2]}" TextType="Html"/>

排查要点 #

如果绑定后无内容显示，按以下顺序核对：

• 页面的DataContext是否正确赋值为MyClass的实例
• 绑定的属性名/字段名和JSON中的key大小写是否完全匹配
• 如果是异步加载JSON内容，MyClass需要实现INotifyPropertyChanged接口，属性更新时触发通知UI刷新。

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