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 a seguir mostra como criar um DataTemplate embutido. Especifica DataTemplate que cada item de dados aparece como três TextBlock elementos dentro de um StackPanel. Neste exemplo, o objeto de dados é uma classe chamada Task. Observe que cada TextBlock elemento neste modelo está associado 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 uma DataTemplate seção de recursos para que possa ser um objeto reutilizável, como no exemplo a seguir:

<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, é possível usar o myTaskTemplate como recurso, como no exemplo a seguir:

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

Para ver a amostra completa, consulte Amostra da introdução à modelagem de dados.

Comentários

Você usa um DataTemplate para especificar a visualização de seus objetos de dados. DataTemplate os objetos são particularmente úteis quando você está associando um ItemsControl tal a uma ListBox coleção inteira. Sem instruções específicas, um ListBox exibe a representação de cadeia de caracteres dos objetos em uma coleção. Nesse caso, você pode usar um DataTemplate para definir a aparência de seus objetos de dados. O conteúdo do seu DataTemplate se torna a estrutura visual de seus objetos de dados.

Para obter uma discussão aprofundada, consulte a Visão geral do Data Templating.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate
• Data Binding Demo