DataTemplate 类

定义

public ref class DataTemplate : System::Windows::FrameworkTemplate

[System.Windows.Markup.DictionaryKeyProperty("DataTemplateKey")]
public class DataTemplate : System.Windows.FrameworkTemplate

[<System.Windows.Markup.DictionaryKeyProperty("DataTemplateKey")>]
type DataTemplate = class
    inherit FrameworkTemplate

Public Class DataTemplate
Inherits FrameworkTemplate

继承

Object

DispatcherObject

FrameworkTemplate

DataTemplate

派生

System.Windows.Controls.ItemContainerTemplate

System.Windows.HierarchicalDataTemplate

属性

DictionaryKeyPropertyAttribute

示例

以下示例演示如何创建 DataTemplate 内联。 指定 DataTemplate 每个数据项在一个中显示为三 TextBlock 个 StackPanel元素。 在此示例中，数据对象是一 Task个名为 的类。 请注意， TextBlock 此模板中的每个元素都绑定到类的属性 Task 。

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}">
   <ListBox.ItemTemplate>
     <DataTemplate>
       <StackPanel>
         <TextBlock Text="{Binding Path=TaskName}" />
         <TextBlock Text="{Binding Path=Description}"/>
         <TextBlock Text="{Binding Path=Priority}"/>
       </StackPanel>
     </DataTemplate>
   </ListBox.ItemTemplate>
 </ListBox>

更常见的是在资源部分中定义一个 DataTemplate ，以便它可以是可重用的对象，如以下示例所示：

<Window.Resources>

<DataTemplate x:Key="myTaskTemplate">
  <StackPanel>
    <TextBlock Text="{Binding Path=TaskName}" />
    <TextBlock Text="{Binding Path=Description}"/>
    <TextBlock Text="{Binding Path=Priority}"/>
  </StackPanel>
</DataTemplate>

</Window.Resources>

现在，可以使用 myTaskTemplate 作为资源，如以下示例所示：

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}"
         ItemTemplate="{StaticResource myTaskTemplate}"/>

有关完整示例，请参阅 数据模板化示例简介。

注解

使用 a DataTemplate 指定数据对象的可视化效果。 DataTemplate将此类ListBox对象绑定到ItemsControl整个集合时特别有用。 如果没有特定说明，则显示 ListBox 集合中对象的字符串表示形式。 在这种情况下，可以使用 a DataTemplate 来定义数据对象的外观。 内容 DataTemplate 将成为数据对象的可视结构。

有关深入讨论，请参阅 数据模板化概述。

另请参阅

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate