WPF自定义控件与页面双向绑定异常：列表为空求助

嘿，我帮你捋捋WPF自定义控件和页面ViewModel双向绑定的那些坑——你说之前把属性直接放页面上功能正常，说明核心的页码计算逻辑没问题，大概率是自定义控件的绑定机制没搞对，导致数据没传通，列表才空了。下面一步步排查：

一、先把自定义控件的依赖属性写对 #

双向绑定的核心就是依赖属性，要是这里写错了，绑定根本传不通。比如你用来计算页码的TotalItems（总条目数）和PageSize（每页条数），必须定义成依赖属性，而且要默认开启双向绑定，还要加属性变更的回调来触发页码计算。

举个例子，正确的依赖属性写法应该是这样：

public static readonly DependencyProperty TotalItemsProperty =
    DependencyProperty.Register(
        nameof(TotalItems),
        typeof(int),
        typeof(YourCustomControl),
        new FrameworkPropertyMetadata(
            0,
            FrameworkPropertyMetadataOptions.BindsTwoWayByDefault, // 重点：默认双向绑定，不用在页面里额外写Mode=TwoWay
            OnTotalItemsChanged));

public int TotalItems
{
    get => (int)GetValue(TotalItemsProperty);
    set => SetValue(TotalItemsProperty, value);
}

private static void OnTotalItemsChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    var control = (YourCustomControl)d;
    control.CalculatePageNumbers(); // 属性一变就重新算页码
}

PageSize也照这个模式写，别偷懒用普通CLR属性，那样根本没法双向绑定。

二、自定义控件内部的列表绑定要找准对象 #

自定义控件XAML里的页码列表（比如ItemsControl），可不能直接绑ViewModel的属性，得绑控件自己的页码集合。因为控件的DataContext默认会继承页面的ViewModel，你要是直接写ItemsSource="{Binding PageNumbers}"，它会去ViewModel里找这个属性，自然找不到，列表就空了。

正确的写法是用RelativeSource指定绑定到自定义控件本身：

<ItemsControl ItemsSource="{Binding RelativeSource={RelativeSource AncestorType=local:YourCustomControl}, Path=PageNumbers}">
    <!-- 这里写你的页码ItemTemplate -->
</ItemsControl>

另外，你的PageNumbers集合必须用ObservableCollection<int>，不能用普通List<int>——普通列表变了UI不会自动更新，ObservableCollection才会通知UI刷新。

三、页面里绑定自定义控件的属性到ViewModel #

在页面的XAML里用自定义控件时，直接把它的依赖属性绑到ViewModel的对应属性就行，因为我们已经在依赖属性里设了默认双向绑定，不用额外加Mode=TwoWay：

<local:YourCustomControl 
    TotalItems="{Binding TotalItemsInViewModel}"
    PageSize="{Binding PageSizeInViewModel}" />

别忘了你的ViewModel必须实现INotifyPropertyChanged接口，不然ViewModel的属性变了，UI根本收不到通知：

public class YourPageViewModel : INotifyPropertyChanged
{
    private int _totalItemsInViewModel;
    public int TotalItemsInViewModel
    {
        get => _totalItemsInViewModel;
        set
        {
            _totalItemsInViewModel = value;
            OnPropertyChanged();
        }
    }

    // PageSize属性也照这个模式写

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

四、排查绑定错误的小技巧 #

打开Visual Studio的输出窗口（Debug模式下），WPF会把所有绑定失败的信息都打出来——比如找不到属性、类型不匹配、DataContext不对之类的，看一眼就能定位大部分问题，比瞎猜管用多了。

另外，确认一下页面的DataContext是不是真的设成了ViewModel的实例，比如在页面构造函数里写DataContext = new YourPageViewModel();，别漏了这一步。

五、走一遍逻辑流程验证 #

最后你可以顺着流程走一遍，看看哪一步断了：

1. ViewModel里的TotalItemsInViewModel变了 → 触发PropertyChanged通知UI
2. 自定义控件的TotalItems依赖属性收到变更 → 触发OnTotalItemsChanged回调
3. 执行CalculatePageNumbers计算页码 → 更新PageNumbers集合（ObservableCollection）
4. 自定义控件的ItemsControl绑定到PageNumbers → 刷新显示页码列表

要是哪一步没触发，就对应排查：比如是不是CalculatePageNumbers里没正确填充PageNumbers，或者PageNumbers没实例化就用了。

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