WPF中DataGrid添加选择框的实现

在使用WPF的过程中,经常会遇到在DataGrid的最前或最后添加一列选择框的需求。今天我们将分享在自己的项目中如何实现这一功能。

整体实现效果如下:

如果对此感兴趣,可以接下来看具体实现部分。

实践

假设数据库中的模型如下:

  public class Person
  {
      public int Id { get; set; }
      public string? Name { get; set; } 
      public string? Home { get; set; }
  }

为了实现这个需求,需要为模型增加一个bool类型的属性表示是否选中,但这个属性只是为了在界面上显示,不需要存入数据库。因此,数据库中的模型与MVVM模式中的模型可能会有一些不同。为了使用MVVM模式,模型也要实现

INotifyPropertyChanged

。这种情况很常见,因为为了使用MVVM模式,模型也要实现

INotifyPropertyChanged

,如果数据库模型与MVVM中的模型是同一个的话,会让模型结构变得不直观。

这时候可以建立一个

PersonViewModel

类,如下所示:

 public partial class PersonViewModel : ObservableObject
 {
     [ObservableProperty]
     private int id;

     [ObservableProperty]
     private string? name;

     [ObservableProperty]
     private string? home;

     [ObservableProperty]
     private bool isSelected;

     public PersonViewModel(Person person)
     {
         this.Id = person.Id;
         this.Name = person.Name;
         this.Home = person.Home;
         this.IsSelected = false;
     }
 }

这里使用了CommunityToolkit.Mvvm包简化实现MVVM模式:

创建ViewModel:

public partial class DataGridDemoViewModel : ObservableObject
{
    [ObservableProperty]
    private ObservableCollection<PersonViewModel> people;

    public DataGridDemoViewModel()
    {
        People = new ObservableCollection<PersonViewModel>();
    }

    [RelayCommand]
    private void GetPeople()
    {
        var people = GetPeopleFromDataBase();
        var peopleViewModels = people.Select(n => new PersonViewModel(n));
        People.AddRange(peopleViewModels);
    }
  
    List<Person> GetPeopleFromDataBase()
    {
        var People = new List<Person>()
        {
            new Person { Id = 1, Name = "小一", Home = "北京" },
            new Person { Id = 2, Name = "小二", Home = "上海" },
            new Person { Id = 3, Name = "王五", Home = "广州" },
            new Person { Id = 4, Name = "小红", Home = "深圳" },
            new Person { Id = 5, Name = "小绿", Home = "杭州" },
            new Person { Id = 6, Name = "小刚", Home = "南京" },
        };
        return People;
    }
}

首先使用

GetPeopleFromDataBase

模拟从数据库中获取类型为

List<Person>

的数据:

 List<Person> GetPeopleFromDataBase()
    {
        var People = new List<Person>()
        {
            new Person { Id = 1, Name = "小一", Home = "北京" },
            new Person { Id = 2, Name = "小二", Home = "上海" },
            new Person { Id = 3, Name = "王五", Home = "广州" },
            new Person { Id = 4, Name = "小红", Home = "深圳" },
            new Person { Id = 5, Name = "小绿", Home = "杭州" },
            new Person { Id = 6, Name = "小刚", Home = "南京" },
        };
        return People;
    }

为了在页面上实现增减通知,一般在ViewModel中使用的是

ObservableCollection<T>

而不是

List<T>

,因此需要一个转换:

 var people = GetPeopleFromDataBase();
 var peopleViewModels = people.Select(n => new PersonViewModel(n));

由于

ObservableCollection<T>

没有实现

AddRange

方法,可以使用扩展方法写一下。


扩展方法(Extension Methods)

是C#中的一种特殊方法,允许向现有类型添加新方法,而无需修改原始类型的代码或创建派生类型。扩展方法必须在静态类中定义,并且第一个参数前带有

this

关键字,指定要扩展的类型。这使得可以为内置类型或第三方库中的类型添加自定义方法,从而提高代码的可读性和重用性。扩展方法的使用方式与实例方法相同,可以通过实例直接调用。

添加的扩展方法如下所示:

  public static class ObservableCollectionExtensions
  {
      public static void AddRange<T>(this ObservableCollection<T> collection, IEnumerable<T> range)
      {
          foreach (var item in range)
          {
              collection.Add(item);
          }
      }
  }

现在来创建View:

<StackPanel>
    <StackPanel>
        <TabControl Margin="0,8,0,0">
            <TabItem>
                <TabItem.Header>
                    <StackPanel Orientation="Horizontal">
                        <ui:SymbolIcon Margin="0,0,6,0" Symbol="Home24" />
                        <TextBlock Text="DataGrid添加选择框Demo" />
                    </StackPanel>
                </TabItem.Header>
                <StackPanel>
                    <StackPanel Orientation="Horizontal">
                        <Menu FontSize="14">
                            <ui:MenuItem Header="操作菜单" Icon="{ui:SymbolIcon ToolBox28}">
                                <ui:MenuItem Header="获取People集合" 
                                      Icon="{ui:SymbolIcon Search16}"
                                      Command="{Binding GetPeopleCommand}"/>                              
                            </ui:MenuItem>
                            <Separator />
                        </Menu>
                    </StackPanel>
                    <StackPanel>
                        <ui:DataGrid Height="400" ItemsSource="{Binding People}">
                        </ui:DataGrid>
                    </StackPanel>
                </StackPanel>
            </TabItem>
        </TabControl>
    </StackPanel>
</StackPanel>


<ui:DataGrid Height="400" ItemsSource="{Binding People}">
</ui:DataGrid>

直接将

ItemsSource

绑定至

People

集合就行了。

<ui:MenuItem Header="获取People集合" 
             Icon="{ui:SymbolIcon Search16}"
             Command="{Binding GetPeopleCommand}"/>    

绑定

GetPeopleCommand

命令即可。

实现的效果如下所示:

实现了添加选择框的效果,但一个一个点太麻烦了,这时候可以增加全选与取消全选的功能。

在菜单中添加这两项功能:

 <Menu FontSize="14">
     <ui:MenuItem Header="操作菜单" Icon="{ui:SymbolIcon ToolBox28}">
         <ui:MenuItem Header="获取People集合" 
               Icon="{ui:SymbolIcon Search16}"
               Command="{Binding GetPeopleCommand}"/>
         <ui:MenuItem Header="全部选中" 
               Icon="{ui:SymbolIcon SelectAllOn24}"
               Command="{Binding SelectAllPeopleCommand}"/>
         <ui:MenuItem Header="取消全部选中" 
               Icon="{ui:SymbolIcon SelectAllOff24}"
               Command="{Binding UnselectAllPeopleCommand}"/>
     </ui:MenuItem>
     <Separator />
 </Menu>

在ViewModel中添加这两个命令:

 [RelayCommand]
 private void SelectAllPeople()
 {
     foreach (var person in People)
     {
         person.IsSelected = true;
     }
 }

 [RelayCommand]
 private void UnselectAllPeople()
 {
     foreach (var person in People)
     {
         person.IsSelected = false;
     }
 }

现在在看看看效果:

回顾

通过这个Demo,总体上学习了MVVM模式的简单使用。MVVM中的Model不一定就是数据库的Model可以自己根据页面显示的需要增减属性。为了简化MVVM模式的实现,可以借助一些MVVM库,本文使用的是

CommunityToolkit.Mvvm

,使用了

ObservableObject

基类、

[ObservableProperty]

特性与

[RelayCommand]

特性。当发现类型缺少我们需要的方法时,可以使用扩展方法写一个。为了减少和页面耦合,MVVM模式中使用命令而不是事件。

在WPF的MVVM(Model-View-ViewModel)模式中,使用命令而不是事件的主要原因包括以下几点:


  1. 解耦

    :命令将用户界面(View)与业务逻辑(ViewModel)分离,使得两者之间的耦合度降低。这有助于提高代码的可维护性和可测试性。

  2. 可测试性

    :命令使得ViewModel中的逻辑更容易进行单元测试,因为命令可以独立于UI进行测试,而事件则需要依赖于特定的UI元素。

  3. 一致性

    :命令提供了一种一致的方式来处理用户操作,无论这些操作是通过按钮点击、菜单选择还是其他UI元素触发的。

  4. 数据绑定

    :命令可以通过数据绑定直接与UI元素关联,这使得ViewModel可以控制UI元素的启用和禁用状态,而无需直接操作UI元素。

  5. 复用性

    :命令可以在不同的UI元素之间复用,而事件通常与特定的UI元素绑定,复用性较差。

通过使用命令,开发者可以更好地遵循MVVM模式的原则,实现更清晰、更模块化的代码结构。

以上就是通过这个Demo,我们可以简单了解的一些内容,希望对你有所帮助。

未经允许不得转载:大白鲨游戏网 » WPF中DataGrid添加选择框的实现