萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

WPF DataGrid CheckBox 綁定 Bool 屬性完整範例

前言

WPF DataGrid 中的 CheckBox 欄位綁定到資料實體的 `bool` 屬性,需正確設定 `Mode=TwoWay`、`UpdateSourceTrigger=PropertyChanged` 以即時同步。本文提供完整 XAML 與 ViewModel 範例。

XAML 範例

<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>

ViewModel 實作 (INotifyPropertyChanged)

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 控制項樣式、動畫、命令綁定時使用。

常見問題

  1. 點一下不生效:缺少 `UpdateSourceTrigger=PropertyChanged` 或實體未實作 `INotifyPropertyChanged`。
  2. 全選/反選:在 ViewModel 加 `SelectAllCommand` 迴圈設定每個 Item 的屬性,UI 自動更新。
  3. 資料庫儲存:配合 Entity Framework,`SaveChanges()` 時會自動偵測 bool 屬性變更寫回 bit 欄位。
copyright © 萬盛學電腦網 all rights reserved