WPF UserControl中DataGrid绑定ObservableCollection失败问题

看起来你遇到了WPF里DataGrid绑定数据只出表头的经典问题，我来帮你一步步排查和解决，结合你的代码场景：

1. 确认DataContext是否正确设置 #

这是最常见的原因——你的UserControl根本没和ViewModel建立关联。你需要确保UserControl的DataContext指向你的ViewModel实例：

方法一：在XAML中设置 #

<UserControl x:Class="Gui.YourUserControlName"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:Gui">
    <UserControl.DataContext>
        <local:YourViewModelName /> <!-- 替换成你的ViewModel类名 -->
    </UserControl.DataContext>
    <!-- 你的DataGrid放在这里 -->
</UserControl>

方法二：在代码后台设置 #

如果你的ViewModel是从外部传入的（比如父窗口传递），可以在UserControl的构造函数里设置：

public YourUserControlName(YourViewModelName viewModel)
{
    InitializeComponent();
    DataContext = viewModel;
}

2. 检查DataGrid的列绑定是否正确 #

确保DataGrid的列绑定路径和LogItem的属性名完全匹配（大小写敏感）。比如你的LogItem有Type和Message属性，DataGrid的列应该这么写：

<DataGrid ItemsSource="{Binding YourObservableCollectionName}" AutoGenerateColumns="False">
    <DataGrid.Columns>
        <DataGridTextColumn Header="Type" Binding="{Binding Type}" />
        <DataGridTextColumn Header="Message" Binding="{Binding Message}" />
    </DataGrid.Columns>
</DataGrid>

注意：把YourObservableCollectionName替换成ViewModel中那个ObservableCollection的属性名，比如如果ViewModel里是public ObservableCollection<LogItem> LogEntries { get; }，那绑定就是{Binding LogEntries}。

3. 确保ObservableCollection已正确初始化 #

ViewModel里的集合必须先实例化，否则添加数据也不会被DataGrid感知到。比如：

public class YourViewModelName
{
    // 直接初始化集合，确保不为null
    public ObservableCollection<LogItem> LogEntries { get; } = new ObservableCollection<LogItem>();

    // 添加数据的方法示例
    public void AddLog(string type, string message)
    {
        LogEntries.Add(new LogItem(type, message));
    }
}

如果你的集合是后来赋值的（比如public ObservableCollection<LogItem> LogEntries { get; set; }然后在构造函数里LogEntries = new ObservableCollection<LogItem>();），那ViewModel需要实现INotifyPropertyChanged接口，否则DataGrid不会知道集合已经被赋值了。

4. 验证LogItem的属性是否符合绑定要求 #

你的LogItem类的属性已经是public且有getter/setter，这没问题，但要确保没有把属性写成私有或者内部（internal）——WPF绑定默认只能访问public属性。

5. 检查是否在UI线程更新集合 #

如果你的Add操作是在后台线程执行的，必须切换回UI线程才能让DataGrid正确更新。比如用Dispatcher：

Application.Current.Dispatcher.Invoke(() =>
{
    LogEntries.Add(new LogItem("Info", "后台线程添加的日志"));
});

快速排查小技巧 #

• 打开Visual Studio的输出窗口（Debug模式下），如果绑定有错误，会在这里显示类似BindingExpression path error: 'XXX' property not found on 'object' ''YourViewModelName'的提示，根据提示修正即可。

按照上面的步骤逐一排查，应该就能解决数据不显示的问题了！

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