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}"/>

Полный пример см. в разделе Введение в шаблон данных.

Комментарии

Вы используете для DataTemplate указания визуализации объектов данных. DataTemplate объекты особенно полезны при привязке ItemsControl , например ListBox к всей коллекции. Без определенных инструкций отображается ListBox строковое представление объектов в коллекции. В этом случае можно использовать DataTemplate для определения внешнего вида объектов данных. Содержимое DataTemplate становится визуальной структурой объектов данных.

Подробное обсуждение см. в разделе "Общие сведения о шаблоне данных".

См. также раздел

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate