C# WPF MVVM中SyncFusion图表VisibilityOnLegend绑定失效求助

问题描述 #

使用SyncFusion的FastLineBitmapSeries图表组件时，VisibilityOnLegend属性绑定功能失效，但同一BoolToVisibility转换器在其他属性上可正常工作。

相关代码 #

XAML代码 #

<chart:FastLineBitmapSeries 
    DataContext="{Binding AllSeries[VT8PvPower]}" 
    Interior="#7f84e8" 
    VisibilityOnLegend="{Binding AllSeriesVisibility[VT10PvPower], Converter={StaticResource BoolToVisibility}, Mode=TwoWay}" />

注：DataContext绑定正常，但VisibilityOnLegend绑定无效果。

ViewModel代码 #

public ObservableDictionary<string, bool> AllSeriesVisibility { get; set; } = new ObservableDictionary<string, bool>();

AllSeriesVisibility键值结构与AllSeries一致，值并非始终为true。

转换器代码 #

public class VisibilityConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (!(value is bool bValue))
            return Visibility.Hidden;
        return bValue ? Visibility.Visible : Visibility.Collapsed;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        throw new NotImplementedException();
    }
}

问题排查与解决方案 #

1. 绑定上下文错误 #

FastLineBitmapSeries已设置DataContext="{Binding AllSeries[VT8PvPower]}"，默认情况下VisibilityOnLegend的绑定会基于这个子级上下文，无法找到ViewModel中的AllSeriesVisibility属性。

修复方式：指定绑定源为ViewModel，比如通过RelativeSource：

<chart:FastLineBitmapSeries 
    DataContext="{Binding AllSeries[VT8PvPower]}" 
    Interior="#7f84e8" 
    VisibilityOnLegend="{Binding DataContext.AllSeriesVisibility[VT10PvPower], 
        RelativeSource={RelativeSource AncestorType=Window}, 
        Converter={StaticResource BoolToVisibility}, Mode=TwoWay}" />

或使用ElementName（需给父容器命名，如Root）：

VisibilityOnLegend="{Binding DataContext.AllSeriesVisibility[VT10PvPower], 
    ElementName=Root, 
    Converter={StaticResource BoolToVisibility}, Mode=TwoWay}"

2. 属性类型不匹配（核心原因） #

SyncFusion的VisibilityOnLegend属性原生接收bool类型（true显示图例项，false隐藏），不需要转换为Visibility枚举。你误用了转换器，导致类型不匹配，绑定失效。

最优修复方式：移除转换器，直接绑定bool值，同时修正上下文：

<chart:FastLineBitmapSeries 
    DataContext="{Binding AllSeries[VT8PvPower]}" 
    Interior="#7f84e8" 
    VisibilityOnLegend="{Binding DataContext.AllSeriesVisibility[VT10PvPower], 
        RelativeSource={RelativeSource AncestorType=Window}, Mode=TwoWay}" />

3. 双向绑定转换器缺失 #

若需要保留双向绑定（比如通过图例点击控制系列显示状态），当前转换器未实现ConvertBack方法，会导致绑定报错。需补充实现：

public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
{
    if (value is Visibility visibility)
        return visibility == Visibility.Visible;
    return false;
}

但结合第2点，直接绑定bool值更符合组件设计，无需转换器。

验证步骤 #

1. 优先尝试移除转换器+修正绑定上下文，确认绑定是否生效；
2. 查看VS输出窗口的绑定错误提示，排查是否存在属性找不到、类型不匹配等问题；
3. 确认ObservableDictionary的键值变化能正确触发通知（ObservableDictionary原生支持键值变更通知）。

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