如何修复LiveCharts LabelVisual的Text属性绑定匹配错误？

错误信息 #

无法为LiveChartsCore:LiveChartsCore.VisualElements.LabelVisual`2类型的Text属性找到合适的setter或adder，参数为Avalonia.Markup.Xaml:Avalonia.Markup.Xaml.MarkupExtensions.CompiledBindingExtension，可用的setter参数列表为System.String，行46，位置62。

相关代码 #

LineSmoothness.axaml #

<UserControl xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
             mc:Ignorable="d" d:DesignWidth="600" d:DesignHeight="200"
             x:Class="AvaloniaApplication1.Views.LineSmoothness"
             x:DataType="vms:ViewModelLineSmoothness"
             xmlns:lvc="using:LiveChartsCore.SkiaSharpView"
             xmlns:ve="using:LiveChartsCore.SkiaSharpView.VisualElements"
             xmlns:lvca="using:LiveChartsCore.SkiaSharpView.Avalonia"
             xmlns:lvcp="using:LiveChartsCore.SkiaSharpView.Painting"
             xmlns:lvK="using:LiveChartsCore.Kernel"
             xmlns:vms="using:AvaloniaApplication1.ViewModels">
    <UserControl.DataContext>
        <vms:ViewModelLineSmoothness/>
    </UserControl.DataContext>
    <Design.DataContext>
        <vms:ViewModelLineSmoothness/>
    </Design.DataContext>
    <lvca:CartesianChart Name="ChartLine">
        <lvca:CartesianChart.VisualElements>
            <ve:LabelVisual TextSize="15" HorizontalAlignment="Start" Text="{Binding TextMarker}"/>
        </lvca:CartesianChart.VisualElements>
    </lvca:CartesianChart>
</UserControl>

ViewModelLineSmoothness.cs #

internal partial class ViewModelLineSmoothness : ObservableObject, IItemViewModel
{
    public string TextMarker { get; set; }

    public ViewModelLineSmoothness()
    {
    }
}

解决方法 #

报错原因是LabelVisual不属于Avalonia原生控件，不支持Avalonia的编译绑定（CompiledBinding），而你的UserControl通过x:DataType启用了全局编译绑定模式，导致绑定无法匹配Text属性的string类型setter。

有两种可行的解决方式：

1. 单独禁用该绑定的编译模式
   在绑定表达式中显式指定绑定模式，或者使用路径绑定语法强制回退到传统反射绑定：

   <!-- 方式1：指定绑定模式 -->
   <ve:LabelVisual TextSize="15" HorizontalAlignment="Start" Text="{Binding TextMarker, Mode=OneWay}"/>
   
   <!-- 方式2：使用Path语法 -->
   <ve:LabelVisual TextSize="15" HorizontalAlignment="Start" Text="{Binding Path=TextMarker}"/>
   

2. 移除全局编译绑定配置
   如果不需要整个UserControl使用编译绑定，可以删除x:DataType="vms:ViewModelLineSmoothness"这一行，所有绑定会自动切换为传统反射绑定，即可正常识别LabelVisual的Text属性setter。

额外建议：给TextMarker字段初始化默认值，避免潜在的空引用问题：

public string TextMarker { get; set; } = string.Empty;

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