如何正确绑定数据至Syncfusion SfChart以显示图表？

以下是针对图表显示为空的核心排查步骤和正确绑定方式：

1. 确保数据实体类符合要求 #

Syncfusion Chart需要实体类的属性为公共可访问，如果后续会动态更新数据，建议实现INotifyPropertyChanged接口以保证属性变更通知：

// StatisticsClasses.cs
using System.ComponentModel;
using System.Runtime.CompilerServices;

public class SymptomDate : INotifyPropertyChanged
{
    private DateTime _recordDate;
    private int _symptomCount;

    // 必须是公共属性，且名称与XAML中的BindingPath完全匹配
    public DateTime RecordDate
    {
        get => _recordDate;
        set
        {
            _recordDate = value;
            OnPropertyChanged();
        }
    }

    public int SymptomCount
    {
        get => _symptomCount;
        set
        {
            _symptomCount = value;
            OnPropertyChanged();
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;

    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

2. 正确定义并初始化ObservableCollection #

在Dashboard.xaml.cs中，集合必须是公共属性，并确保设置页面的BindingContext，让XAML能找到数据源：

// Dashboard.xaml.cs
using System.Collections.ObjectModel;
using Xamarin.Forms;

public partial class Dashboard : ContentPage
{
    // 公共ObservableCollection属性
    public ObservableCollection<SymptomDate> SymptomDates { get; set; }

    public Dashboard()
    {
        InitializeComponent();
        // 将页面自身设为BindingContext，或者使用独立ViewModel
        BindingContext = this;

        // 初始化集合并添加测试数据
        SymptomDates = new ObservableCollection<SymptomDate>();
        SymptomDates.Add(new SymptomDate
        {
            RecordDate = DateTime.Today,
            SymptomCount = 3
        });
    }
}

如果后续需要重新赋值集合（而不是仅增删元素），建议给集合属性添加setter并触发PropertyChanged（需让页面实现INotifyPropertyChanged）。

3. XAML中正确配置SfChart #

确保命名空间引用、坐标轴类型与数据匹配，且Series的绑定参数准确：

<!-- Dashboard.xaml -->
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:syncfusion="clr-namespace:Syncfusion.SfChart.XForms;assembly=Syncfusion.SfChart.XForms"
             x:Class="YourNamespace.Dashboard">

    <syncfusion:SfChart>
        <!-- X轴：匹配日期类型数据 -->
        <syncfusion:SfChart.PrimaryAxis>
            <syncfusion:DateTimeAxis Title="记录日期" />
        </syncfusion:SfChart.PrimaryAxis>

        <!-- Y轴：匹配数值类型数据 -->
        <syncfusion:SfChart.SecondaryAxis>
            <syncfusion:NumericalAxis Title="症状数量" />
        </syncfusion:SfChart.SecondaryAxis>

        <!-- 柱状图示例，ItemsSource绑定集合，X/Y路径对应实体类属性 -->
        <syncfusion:ColumnSeries 
            ItemsSource="{Binding SymptomDates}"
            XBindingPath="RecordDate"
            YBindingPath="SymptomCount"
            Label="每日症状记录" />
    </syncfusion:SfChart>
</ContentPage>

4. 常见错误排查 #

• BindingContext未设置：XAML无法找到数据源，必须通过BindingContext = this;或ViewModel关联。
• 属性名拼写错误：XBindingPath和YBindingPath的字符串必须与实体类属性名大小写完全匹配。
• 集合访问权限不足：SymptomDates必须是public属性，否则XAML无法访问。
• NuGet包缺失：确认已安装Syncfusion.Xamarin.SfChart包，并在XAML中正确引用命名空间。

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