DataTemplate Classe

Definição

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

Herança

Object

DispatcherObject

FrameworkTemplate

DataTemplate

Derivado

System.Windows.Controls.ItemContainerTemplate

System.Windows.HierarchicalDataTemplate

Atributos

DictionaryKeyPropertyAttribute

Exemplos

O exemplo seguinte mostra como criar um DataTemplate inline. Especifica DataTemplate que cada elemento de dados aparece como três TextBlock elementos dentro de um StackPanel. Neste exemplo, o objeto de dados é uma classe chamada Task. Note que cada TextBlock elemento neste modelo está ligado a uma propriedade da Task classe.

<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>

É mais comum definir a DataTemplate na secção de recursos para que possa ser um objeto reutilizável, como no seguinte exemplo:

<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>

Agora você pode usar myTaskTemplate como um recurso, como no exemplo a seguir:

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

Para obter o exemplo completo, consulte Introdução ao exemplo de modelagem de dados.

Observações

Usas a DataTemplate para especificar a visualização dos teus objetos de dados. DataTemplate Os objetos são particularmente úteis quando está a vincular um ItemsControl , como A ListBox , a uma coleção inteira. Sem instruções específicas, a ListBox apresenta a representação da cadeia de caracteres dos objetos numa coleção. Nesse caso, pode usar a DataTemplate para definir a aparência dos seus objetos de dados. O conteúdo de Your DataTemplate torna-se a estrutura visual dos teus objetos de dados.

Para uma discussão aprofundada, consulte Visão Geral sobre Modelos de Dados.

Ver também

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate