当前位置：首页 > C# > 正文

WPF数据模板入门指南（手把手教你使用DataTemplate实现动态UI）

主机测评网
C#
2025-12-17
864

在WPF（Windows Presentation Foundation）开发中，DataTemplate 是一个非常核心的概念。它允许你自定义如何显示数据对象，是实现WPF界面开发灵活性和可维护性的关键工具。无论你是刚接触WPF的新手，还是想深入理解 WPF数据模板 的开发者，本教程都将带你从零开始，一步步掌握 DataTemplate 的基本用法。

什么是 DataTemplate？

简单来说，DataTemplate 是一种告诉 WPF “如何显示某个类型的数据”的模板。当你将一个对象绑定到 UI 元素（如 ListBox、ComboBox 或 ContentControl）时，如果没有指定模板，WPF 默认只会调用该对象的 ToString() 方法来显示文本。而通过 DataTemplate，你可以完全控制它的外观：可以包含图片、按钮、布局容器等任意 UI 元素。

WPF数据模板入门指南（手把手教你使用DataTemplate实现动态UI） WPF数据模板 DataTemplate教程 WPF绑定数据 WPF界面开发第1张

创建一个简单的 DataTemplate

我们以一个常见的场景为例：在一个 ListBox 中显示一组用户信息（姓名和邮箱）。首先，定义一个简单的 C# 类：

public class User{    public string Name { get; set; }    public string Email { get; set; }}

接下来，在 XAML 中创建一个 ListBox，并为其设置 DataTemplate：

<Window x:Class="WpfApp.MainWindow"        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"        Title="DataTemplate 示例" Height="350" Width="400">    <Grid>        <ListBox ItemsSource="{Binding Users}">            <ListBox.ItemTemplate>                <DataTemplate>                    <StackPanel Orientation="Horizontal" Margin="5">                        <TextBlock Text="{Binding Name}" FontWeight="Bold" />                        <TextBlock Text=" - " />                        <TextBlock Text="{Binding Email}" Foreground="Gray" />                    </StackPanel>                </DataTemplate>            </ListBox.ItemTemplate>        </ListBox>    </Grid></Window>

在后台代码中，为 DataContext 设置数据源：

public partial class MainWindow : Window{    public List<User> Users { get; set; }    public MainWindow()    {        InitializeComponent();        Users = new List<User>        {            new User { Name = "张三", Email = "zhangsan@example.com" },            new User { Name = "李四", Email = "lisi@example.com" }        };        DataContext = this;    }}

全局 DataTemplate 与资源字典

如果你希望在整个应用中统一某种类型的显示方式，可以把 DataTemplate 定义在 App.xaml 的资源字典中，并指定 DataType。这样，所有绑定该类型的地方都会自动使用这个模板，无需重复定义。

<Application.Resources>    <DataTemplate DataType="{x:Type local:User}">        <Border Background="LightBlue" Padding="8" Margin="2" CornerRadius="4">            <StackPanel>                <TextBlock Text="{Binding Name}" FontSize="16" FontWeight="Bold" />                <TextBlock Text="{Binding Email}" FontSize="12" Foreground="DarkSlateGray" />            </StackPanel>        </Border>    </DataTemplate></Application.Resources>

注意：这里的 local 是你在 XAML 中声明的命名空间前缀，指向包含 User 类的程序集。