WPF DataTemplate数据模板的详细使用教程

WPF 中的 DataTemplate 是用于定义如何显示绑定数据对象的模板。它通常用于 ListBox、ComboBox、ListView 等控件，以自定义这些控件中每个数据项的外观。下面是 DataTemplate 的详细使用教程。

1. 什么是 DataTemplate？

DataTemplate 定义了如何呈现数据对象。通常，WPF 控件会直接将数据对象转换为字符串并显示出来。如果你想要更复杂的外观（如使用多个控件来显示一个数据对象的不同属性），就需要使用 DataTemplate。

2. 基本使用方式

DataTemplate 最常用于绑定集合的控件中，如 ListBox 或 ListView，以定义每个数据项的显示方式。

示例：
假设你有一个包含 Person 对象的列表，每个 Person 对象有 Name 和 Age 属性。你可以通过 DataTemplate 自定义每个 Person 对象在 ListBox 中的显示方式。

XAML 代码：

<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 Example" Height="350" Width="525">
    <Window.Resources>
        <!-- 定义 DataTemplate -->
        <DataTemplate x:Key="PersonTemplate">
            <StackPanel Orientation="Horizontal">
                <TextBlock Text="{Binding Name}" FontWeight="Bold" Margin="5"/>
                <TextBlock Text="(" Margin="5,0,0,0"/>
                <TextBlock Text="{Binding Age}" />
                <TextBlock Text=" years old)" />
            </StackPanel>
        </DataTemplate>
    </Window.Resources>
    
    <Grid>
        <!-- 使用 DataTemplate -->
        <ListBox ItemTemplate="{StaticResource PersonTemplate}" ItemsSource="{Binding People}" />
    </Grid>
</Window>

C# 代码：

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        DataContext = new ViewModel();
    }
}

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

public class ViewModel
{
    public ObservableCollection<Person> People { get; set; }

    public ViewModel()
    {
        People = new ObservableCollection<Person>
        {
            new Person { Name = "John", Age = 25 },
            new Person { Name = "Jane", Age = 30 },
            new Person { Name = "Mike", Age = 35 }
        };
    }
}

在这个例子中，DataTemplate 定义了 ListBox 每个项的布局：使用一个水平排列的 StackPanel，其中包含名字和年龄。每个 Person 对象通过 {Binding} 将数据传递给相应的 TextBlock。

3. 动态生成的 DataTemplate

你可以在代码中动态创建 DataTemplate。这在某些情况下会很有用，例如当模板需要根据运行时的逻辑生成时。

示例：动态创建 DataTemplate

DataTemplate template = new DataTemplate();
FrameworkElementFactory stackPanelFactory = new FrameworkElementFactory(typeof(StackPanel));
stackPanelFactory.SetValue(StackPanel.OrientationProperty, Orientation.Horizontal);

FrameworkElementFactory textBlockFactory1 = new FrameworkElementFactory(typeof(TextBlock));
textBlockFactory1.SetBinding(TextBlock.TextProperty, new Binding("Name"));
stackPanelFactory.AppendChild(textBlockFactory1);

FrameworkElementFactory textBlockFactory2 = new FrameworkElementFactory(typeof(TextBlock));
textBlockFactory2.SetBinding(TextBlock.TextProperty, new Binding("Age"));
stackPanelFactory.AppendChild(textBlockFactory2);

template.VisualTree = stackPanelFactory;

listBox.ItemTemplate = template;

这个代码在运行时生成了与 XAML 中定义的类似的 DataTemplate。

4. 使用 DataTemplate 选择器

有时，你需要根据某些条件动态选择不同的 DataTemplate。这时，可以使用 DataTemplateSelector。

示例：

public class AgeBasedTemplateSelector : DataTemplateSelector
{
    public DataTemplate YoungTemplate { get; set; }
    public DataTemplate OldTemplate { get; set; }

    public override DataTemplate SelectTemplate(object item, DependencyObject container)
    {
        var person = item as Person;
        if (person != null)
        {
            if (person.Age < 30)
                return YoungTemplate;
            else
                return OldTemplate;
        }
        return base.SelectTemplate(item, container);
    }
}

XAML 使用 DataTemplateSelector：

<Window.Resources>
    <DataTemplate x:Key="YoungTemplate">
        <TextBlock Text="{Binding Name}" Foreground="Green"/>
    </DataTemplate>
    <DataTemplate x:Key="OldTemplate">
        <TextBlock Text="{Binding Name}" Foreground="Red"/>
    </DataTemplate>

    <local:AgeBasedTemplateSelector x:Key="AgeBasedSelector"
                                    YoungTemplate="{StaticResource YoungTemplate}"
                                    OldTemplate="{StaticResource OldTemplate}"/>
</Window.Resources>

<ListBox ItemsSource="{Binding People}" ItemTemplateSelector="{StaticResource AgeBasedSelector}" />

在这个例子中，AgeBasedTemplateSelector 会根据年龄动态选择不同的 DataTemplate。

5. 绑定复杂数据结构

DataTemplate 也可以用于显示更复杂的数据结构。例如，显示 Person 对象中包含的 Address 子对象：

<DataTemplate x:Key="PersonWithAddressTemplate">
    <StackPanel>
        <TextBlock Text="{Binding Name}" FontWeight="Bold"/>
        <TextBlock Text="{Binding Address.Street}" />
        <TextBlock Text="{Binding Address.City}" />
    </StackPanel>
</DataTemplate>

这里，DataTemplate 可以通过层次化的数据绑定展示复杂对象的不同层次。

6. 结论

DataTemplate 是 WPF 中非常强大的工具，允许你自定义数据的显示方式。通过它，能够轻松定义和使用简单或复杂的数据展示形式，并且能够与 DataTemplateSelector 搭配使用，实现动态选择不同的模板。

如果你有其他具体的需求或需要更高级的使用技巧，可以告诉我，我会为你提供进一步的帮助！