C#怎么使用DataGrid_C# WPF表格数据绑定与自定义模板【核心】

为什么 DataGrid 不显示数据？根子往往出在 ItemsSource 上——要么没绑定支持 UI 刷新的集合（比如 ObservableCollection），要么绑定路径写错了。数据对象里的属性必须是 public 的自动属性，并且实现 INotifyPropertyChanged，否则界面不会主动更新。另外，XAML 里 ItemsSource 绑定的那个属性，得是 ViewModel 中已经初始化好的 public 属性，不能只声明不赋值。

绑定集合时为什么 DataGrid 不显示数据

最常见的情况是：明明绑了一个 List，但增删数据时界面纹丝不动。原因很简单——List 不会通知 UI 集合发生了变化。必须换成 ObservableCollection，它实现了 INotifyCollectionChanged，DataGrid 才能感知变化并刷新。除此之外，Person 类的属性必须是 public 的 get/set 自动属性，或者手动实现 INotifyPropertyChanged；直接写字段（比如 public string Name;）是绑定不上的。记得检查 XAML 中 ItemsSource="{Binding People}" 里的 People 是否在 DataContext 对应的 ViewModel 中声明为 public 属性，并且构造函数里已经赋了初始值（不是只声明不赋值）。调试时打开输出窗口，看看有没有 System.Windows.Data Error——它会直接告诉你哪个绑定路径失败了，比如 Property not found 或 Null reference，比瞎猜快得多。

如何禁用自动生成列并手写 DataGridTemplateColumn

默认 AutoGenerateColumns="True"，DataGrid 会按属性名自动生成只读文本列。这样虽然省事，但放不了按钮、下拉框或自定义格式。想完全控制每一列，就得关掉自动生成。做法很直接：设置 AutoGenerateColumns="False"，然后在 DataGrid.Columns 里显式定义各列。如果只需要展示或编辑纯文本，DataGridTextColumn 就够了；但需要按钮、CheckBox、ComboBox 这类复杂控件，就必须用 DataGridTemplateColumn。模板分两种：CellTemplate 控制显示态（比如用 TextBlock 显示文字），CellEditingTemplate 控制编辑态（比如用 TextBox 或 ComboBox），两者可以完全不同。模板内绑定直接用 {Binding Path=Age} 就好，不用加 RelativeSource——每个单元格的 DataContext 默认就是当前数据项（比如一个 Person 对象）。

SelectedItem 绑定失效或总是 null

选中一行后绑定到 SelectedItem，结果总是 null？常见原因有两个：一是没设置 SelectionUnit="FullRow"，二是忽略了事件与属性更新的时机冲突。首先，SelectedItem 是双向绑定，目标属性的类型必须和集合元素类型一致——比如 SelectedItem="{Binding SelectedPerson}"，那么 SelectedPerson 必须是 Person 类型，不能是 object。其次，如果代码里手动调用了 dataGrid.UnselectAll() 或修改了 ItemsSource，会清空 SelectedItem，这时候需要同步更新绑定的属性（比如设为 null）。还要注意：尽量避免在 SelectionChanged 事件里直接改 SelectedItem，容易引发循环赋值。正确的做法是用绑定控制核心逻辑，事件只做副作用（比如加载详情）。调试时可以在 SelectedPerson 属性的 setter 里加断点——如果从来没进入，说明触发源根本不是 DataGrid 的选择动作，很可能是 DataContext 变了或绑定源被重置了。

性能差、滚动卡顿，尤其数据量过千

数据量一大，DataGrid 就变得卡顿，甚至滚动都成问题。其实 DataGrid 默认开启了 UI 虚拟化，但很容器被破坏。最常见的破坏者：把 DataGrid 套在 ScrollViewer 里面，或者给 DataGrid 设置了固定 Height/MaxHeight。一旦虚拟化失效，所有行都会同时渲染，千行数据瞬间卡死。正确做法是：外层不要包裹 ScrollViewer——DataGrid 自带滚动条；不要给它设 Height 或 MaxHeight（除非确实需要限制高度），让它根据内容或父容器自然伸缩。另外关掉不必要的功能：确保 EnableRowVirtualization="True"（默认就是 True，但显式写上更安心），再设置 VirtualizingStackPanel.VirtualizationMode="Recycling" 来复用容器，减少 GC 压力。还有，模板里不要写耗时逻辑，比如在 CellTemplate 里调用数据库或 IO 操作——所有计算提前在 ViewModel 里做好，绑定只读取现成的值。

DataGrid 的坑往往藏在“看起来能跑”的边界场景里。比如绑定路径拼写错一个字母，它不报错只是静默地不显示数据；又比如模板里忘了设 DataContext，却以为是逻辑问题反复排查。其实，动手前先看一眼输出窗口的绑定错误提醒，比猜半天快得多。抓住这些关键点，基本就能避开绝大多数陷阱。