WPF （数据控件1）DataGrid控件的详细使用教程

最新推荐文章于 2025-05-03 20:49:13 发布

原创最新推荐文章于 2025-05-03 20:49:13 发布

· 2.4k 阅读

14 ·

版权

文章标签：

#wpf

WPF 专栏收录该内容

91 篇文章

订阅专栏

WPF 中的 DataGrid 控件是一个非常强大的数据展示控件，可以用来显示、编辑和排序数据。它可以绑定到数据源，自动生成列，支持各种交互功能，如排序、分组、分页、编辑、选择等。

基本功能和使用

1. 定义基本的 DataGrid

要在 WPF 中使用 DataGrid，可以在 XAML 中定义它并绑定到一个数据源。以下是一个简单的 DataGrid 示例：

<DataGrid x:Name="myDataGrid" AutoGenerateColumns="True" />

在这个例子中，AutoGenerateColumns="True" 表示 DataGrid 会自动根据绑定的数据源的属性生成列。

2. 绑定数据源

你可以通过 XAML 或代码将 DataGrid 绑定到数据源。以下是通过代码绑定的示例：

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        List<Person> people = new List<Person>()
        {
            new Person() { Name = "John", Age = 30 },
            new Person() { Name = "Jane", Age = 25 },
            new Person() { Name = "Doe", Age = 35 }
        };

        myDataGrid.ItemsSource = people;
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

此示例中，myDataGrid.ItemsSource 被设置为一个 List<Person> 数据源，DataGrid 会根据 Person 类的属性自动生成列。

手动定义列

有时候你可能希望手动定义列，而不是让 DataGrid 自动生成列。你可以通过 DataGrid.Columns 来指定每个列的显示方式。以下是一个手动定义列的示例：

<DataGrid x:Name="myDataGrid" AutoGenerateColumns="False">
    <DataGrid.Columns>
        <DataGridTextColumn Header="Name" Binding="{Binding Name}" />
        <DataGridTextColumn Header="Age" Binding="{Binding Age}" />
    </DataGrid.Columns>
</DataGrid>

在这个例子中，AutoGenerateColumns 设置为 False，表示手动定义列。通过 DataGridTextColumn 手动指定了 Name 和 Age 两个列，并通过 Binding 将它们绑定到数据源的对应属性。

DataGrid 列类型

WPF DataGrid 支持不同类型的列，你可以根据需要选择不同的列类型：

DataGridTextColumn：显示文本，最常用的一种列。

<DataGridTextColumn Header="Name" Binding="{Binding Name}" />

DataGridCheckBoxColumn：显示复选框，用于表示布尔值。

<DataGridCheckBoxColumn Header="Is Active" Binding="{Binding IsActive}" />

DataGridComboBoxColumn：显示下拉框，用于选择不同的选项。

<DataGridComboBoxColumn Header="Role" SelectedItemBinding="{Binding Role}" ItemsSource="{Binding Roles}" />

DataGridTemplateColumn：通过 DataTemplate 自定义列内容。

<DataGridTemplateColumn Header="Actions">
    <DataGridTemplateColumn.CellTemplate>
        <DataTemplate>
            <Button Content="Edit" Command="{Binding EditCommand}" />
        </DataTemplate>
    </DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>

DataGrid 的交互功能

1. 排序

默认情况下，DataGrid 的列是可以排序的。你只需单击列标题，DataGrid 会自动根据该列的值进行排序。如果需要禁用排序，可以设置 CanUserSort 属性：

<DataGridTextColumn Header="Name" Binding="{Binding Name}" CanUserSort="False" />

2. 编辑

DataGrid 支持编辑数据。要启用编辑功能，需要确保 DataGrid 的 IsReadOnly 属性设置为 False（默认值），并且绑定的数据源支持更新。你可以通过双击单元格来进行编辑操作。

<DataGrid x:Name="myDataGrid" AutoGenerateColumns="False" IsReadOnly="False">
    <DataGrid.Columns>
        <DataGridTextColumn Header="Name" Binding="{Binding Name}" />
        <DataGridTextColumn Header="Age" Binding="{Binding Age}" />
    </DataGrid.Columns>
</DataGrid>

3. 选择

DataGrid 提供了多种选择模式：

单选：DataGrid 允许选择单行。可以通过 SelectionMode="Single" 来指定。
多选：默认值，通过 SelectionMode="Extended" 允许用户使用 Shift 或 Ctrl 键进行多行选择。

<DataGrid x:Name="myDataGrid" SelectionMode="Extended" SelectionUnit="FullRow" />

4. 分组

通过使用 CollectionViewSource，你可以为 DataGrid 启用分组功能。下面是一个简单的分组示例：

<Window.Resources>
    <CollectionViewSource x:Key="peopleDataView" Source="{Binding People}">
        <CollectionViewSource.GroupDescriptions>
            <PropertyGroupDescription PropertyName="Age" />
        </CollectionViewSource.GroupDescriptions>
    </CollectionViewSource>
</Window.Resources>

<DataGrid ItemsSource="{Binding Source={StaticResource peopleDataView}}" />

在这个示例中，数据根据 Age 属性进行分组显示。

5. 样式和外观自定义

你可以通过设置 DataGrid 的 CellStyle、RowStyle 和 ColumnHeaderStyle 来自定义其外观。例如：

<DataGrid>
    <DataGrid.CellStyle>
        <Style TargetType="DataGridCell">
            <Setter Property="Background" Value="LightYellow" />
            <Setter Property="BorderBrush" Value="Gray" />
        </Style>
    </DataGrid.CellStyle>
</DataGrid>

完整的 DataGrid 示例

以下是一个完整的示例，包含手动列定义、数据绑定、排序和选择等功能：

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <DataGrid x:Name="myDataGrid" AutoGenerateColumns="False" SelectionMode="Single">
            <DataGrid.Columns>
                <DataGridTextColumn Header="Name" Binding="{Binding Name}" />
                <DataGridTextColumn Header="Age" Binding="{Binding Age}" />
                <DataGridCheckBoxColumn Header="Is Active" Binding="{Binding IsActive}" />
            </DataGrid.Columns>
        </DataGrid>
    </Grid>
</Window>