DataTemplate Klas

Definitie

Naamruimte:

System.Windows

Assembly:

PresentationFramework.dll

Beschrijft de visuele structuur van een gegevensobject.

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

Overname

Object

DispatcherObject

FrameworkTemplate

DataTemplate

Afgeleid

System.Windows.Controls.ItemContainerTemplate

System.Windows.HierarchicalDataTemplate

Kenmerken

DictionaryKeyPropertyAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u een DataTemplate inline maakt. Hiermee DataTemplate geeft u op dat elk gegevensitem wordt weergegeven als drie TextBlock elementen binnen een StackPanel. In dit voorbeeld is het gegevensobject een klasse met de naam Task. Houd er rekening mee dat elk TextBlock element in deze sjabloon is gebonden aan een eigenschap van de Task klasse.

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

Het is gebruikelijker om een DataTemplate in de sectie resources te definiëren, zodat het een herbruikbaar object kan zijn, zoals in het volgende voorbeeld:

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

U kunt nu myTaskTemplate als resource gebruiken, zoals in het volgende voorbeeld:

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

Voor het volledige voorbeeld, zie Inleiding tot data-templatesample.

Opmerkingen

U gebruikt een DataTemplate om de visualisatie van uw gegevensobjecten op te geven. DataTemplate objecten zijn met name handig wanneer u een ItemsControl zoals een ListBox aan een hele verzameling wilt koppelen. Zonder specifieke instructies wordt ListBox de tekenreeksweergave van de objecten in een verzameling weergegeven. In dat geval kunt u een DataTemplate functie gebruiken om het uiterlijk van uw gegevensobjecten te definiëren. De inhoud van uw DataTemplate gegevens wordt de visuele structuur van uw gegevensobjecten.

Zie Overzicht van gegevens templating voor een uitgebreide discussie.

Constructors

Name	Description
DataTemplate()	Initialiseert een nieuw exemplaar van de DataTemplate klasse.
DataTemplate(Object)	Initialiseert een nieuw exemplaar van de DataTemplate klasse met de opgegeven DataType eigenschap.

Eigenschappen

Name	Description
DataTemplateKey	Hiermee wordt de standaardsleutel van de DataTemplate.
DataType	Hiermee haalt u het type op waarvoor dit is bedoeld of stelt u dit DataTemplate in.
Dispatcher	Hiermee wordt de Dispatcher aan dit DispatcherObject gekoppelde bestand. (Overgenomen van DispatcherObject)
HasContent	Hiermee wordt een waarde opgehaald die aangeeft of deze sjabloon geoptimaliseerde inhoud heeft. (Overgenomen van FrameworkTemplate)
IsSealed	Hiermee wordt een waarde opgehaald die aangeeft of dit object een onveranderbare status heeft, zodat het niet kan worden gewijzigd. (Overgenomen van FrameworkTemplate)
Resources	Hiermee haalt u de verzameling resources op die kunnen worden gebruikt binnen het bereik van deze sjabloon. (Overgenomen van FrameworkTemplate)
Template	Hiermee wordt een verwijzing opgehaald of ingesteld naar het object dat de XAML-knooppunten voor de sjabloon registreert of afspeelt wanneer de sjabloon wordt gedefinieerd of toegepast door een schrijver. (Overgenomen van FrameworkTemplate)
Triggers	Hiermee haalt u een verzameling triggers op die eigenschapswaarden toepassen of acties uitvoeren op basis van een of meer voorwaarden.
VisualTree	Hiermee wordt het hoofdknooppunt van de sjabloon opgehaald of ingesteld. (Overgenomen van FrameworkTemplate)

Methoden

Name	Description
CheckAccess()	Bepaalt of de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindName(String, FrameworkElement)	Hiermee zoekt u het element dat is gekoppeld aan de opgegeven naam die in deze sjabloon is gedefinieerd. (Overgenomen van FrameworkTemplate)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
LoadContent()	Laadt de inhoud van de sjabloon als een exemplaar van een object en retourneert het hoofdelement van de inhoud. (Overgenomen van FrameworkTemplate)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
RegisterName(String, Object)	Registreert een nieuw naam-/objectpaar in het huidige naambereik. (Overgenomen van FrameworkTemplate)
Seal()	Hiermee wordt de sjabloon vergrendeld zodat deze niet kan worden gewijzigd. (Overgenomen van FrameworkTemplate)
ShouldSerializeResources(XamlDesignerSerializationManager)	Retourneert een waarde die aangeeft of serialisatieprocessen de waarde van de Resources eigenschap moeten serialiseren op exemplaren van deze klasse. (Overgenomen van FrameworkTemplate)
ShouldSerializeVisualTree()	Retourneert een waarde die aangeeft of serialisatieprocessen de waarde van de VisualTree eigenschap moeten serialiseren op exemplaren van deze klasse. (Overgenomen van FrameworkTemplate)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
UnregisterName(String)	Hiermee verwijdert u een naam/objecttoewijzing uit de XAML-naamscoop. (Overgenomen van FrameworkTemplate)
ValidateTemplatedParent(FrameworkElement)	Hiermee wordt de bovenliggende sjabloon gecontroleerd op basis van een set regels.
VerifyAccess()	Hiermee wordt afgedwongen dat de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject)

Expliciete interface-implementaties

Name	Description
INameScope.FindName(String)	Retourneert een object met de opgegeven identificatienaam. (Overgenomen van FrameworkTemplate)
IQueryAmbient.IsAmbientPropertyAvailable(String)	Query's of een opgegeven omgevingseigenschap beschikbaar is in het huidige bereik. (Overgenomen van FrameworkTemplate)

Zie ook

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate