WPF DataGrid 中的 CheckBox 欄位綁定到資料實體的 `bool` 屬性,需正確設定 `Mode=TwoWay`、`UpdateSourceTrigger=PropertyChanged` 以即時同步。本文提供完整 XAML 與 ViewModel 範例。
<DataGrid ItemsSource="{Binding Users}" AutoGenerateColumns="False">
<DataGrid.Columns>
<DataGridTextColumn Header="姓名" Binding="{Binding Name}" />
<DataGridCheckBoxColumn Header="啟用" Binding="{Binding IsActive, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />
<!-- 或使用 TemplateColumn 自訂 CheckBox 樣式 -->
<DataGridTemplateColumn Header="管理員">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate>
<CheckBox IsChecked="{Binding IsAdmin, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}"
HorizontalAlignment="Center" VerticalAlignment="Center" />
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
</DataGrid.Columns>
</DataGrid>
public class User : INotifyPropertyChanged
{
private bool _isActive;
public bool IsActive
{
get => _isActive;
set
{
if (_isActive != value)
{
_isActive = value;
OnPropertyChanged(nameof(IsActive));
}
}
}
private bool _isAdmin;
public bool IsAdmin
{
get => _isAdmin;
set
{
if (_isAdmin != value)
{
_isAdmin = value;
OnPropertyChanged(nameof(IsAdmin));
}
}
}
public string Name { get; set; }
public event PropertyChangedEventHandler PropertyChanged;
protected virtual void OnPropertyChanged(string name) => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
}
public class MainViewModel
{
public ObservableCollection<User> Users { get; } = new ObservableCollection<User>();
public MainViewModel()
{
Users.Add(new User { Name = "Alice", IsActive = true, IsAdmin = false });
Users.Add(new User { Name = "Bob", IsActive = false, IsAdmin = true });
}
}
Mode=TwoWay:UI 勾選 → 更新 Source;Source 變更 → 更新 UI。UpdateSourceTrigger=PropertyChanged:關鍵。預設 `LostFocus` 會導致離開儲存格才更新,CheckBox 點擊後不會自動失焦,必須設為 `PropertyChanged` 才能即時寫回。DataGridCheckBoxColumn:內建樣式、支援三態 (加 `IsThreeState="True"`)、效能較好。DataGridTemplateColumn:需完整 CheckBox 控制項樣式、動畫、命令綁定時使用。