DataTemplate Klass

Definition

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

Arv

Object

DispatcherObject

FrameworkTemplate

DataTemplate

Härledda

System.Windows.Controls.ItemContainerTemplate

System.Windows.HierarchicalDataTemplate

Attribut

DictionaryKeyPropertyAttribute

Exempel

I följande exempel visas hur du skapar en DataTemplate infogad. DataTemplate Anger att varje dataobjekt visas som tre TextBlock element i en StackPanel. I det här exemplet är dataobjektet en klass med namnet Task. Observera att varje TextBlock element i den här mallen är bundet till en egenskap för Task klassen.

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

Det är vanligare att definiera en DataTemplate i resursavsnittet så att det kan vara ett återanvändbart objekt, som i följande exempel:

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

Nu kan du använda myTaskTemplate som en resurs, som i följande exempel:

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

För det kompletta exemplet, se Introduktion till datamall-exemplet.

Kommentarer

Du använder en DataTemplate för att ange visualiseringen av dina dataobjekt. DataTemplate objekt är särskilt användbara när du binder en ItemsControl till exempel en ListBox till en hel samling. Utan specifika instruktioner ListBox visas strängrepresentationen av objekten i en samling. I så fall kan du använda en DataTemplate för att definiera utseendet på dina dataobjekt. Innehållet i ditt DataTemplate blir den visuella strukturen för dina dataobjekt.

En djupgående diskussion finns i Översikt över databeräkning.

Se även

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate