DataTemplate Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows

Bütünleştirilmiş Kod:: PresentationFramework.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Veri nesnesinin görsel yapısını açıklar.

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

Devralma: Object

DispatcherObject

FrameworkTemplate
DataTemplate

Türetilmiş: System.Windows.Controls.ItemContainerTemplate

System.Windows.HierarchicalDataTemplate

Öznitelikler: DictionaryKeyPropertyAttribute

Örnekler

Aşağıdaki örnekte satır içi oluşturma DataTemplate gösterilmektedir. her DataTemplate veri öğesinin içinde StackPanelüç TextBlock öğe olarak göründüğünü belirtir. Bu örnekte, veri nesnesi adlı Taskbir sınıftır. Bu şablondaki her TextBlock öğenin sınıfının bir özelliğine Task bağlı olduğunu unutmayın.

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

Aşağıdaki örnekte olduğu gibi yeniden kullanılabilir bir nesne olabilmesi için kaynaklar bölümünde bir tanımlamak DataTemplate daha yaygındır:

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

Artık aşağıdaki örnekte olduğu gibi kaynak olarak kullanabilirsiniz myTaskTemplate :

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

Tam örnek için bkz. Veri Şablon Oluşturma Örneğine Giriş.

Açıklamalar

Veri nesnelerinizin görselleştirmesini belirtmek için bir DataTemplate kullanırsınız. DataTemplate nesneleri özellikle gibi bir ItemsControl ListBox öğesini koleksiyonun tamamına bağlarken kullanışlıdır. Belirli yönergeler olmadan, bir ListBox koleksiyondaki nesnelerin dize gösterimini görüntüler. Bu durumda, veri nesnelerinizin görünümünü tanımlamak için bir DataTemplate kullanabilirsiniz. içeriğiniz DataTemplate , veri nesnelerinizin görsel yapısı haline gelir.

Ayrıntılı bir tartışma için bkz. Veri Şablon oluşturmaya genel bakış.

Oluşturucular

DataTemplate()	DataTemplate sınıfının yeni bir örneğini başlatır.
DataTemplate(Object)	Belirtilen DataType özellik ile sınıfının yeni bir örneğini DataTemplate başlatır.

Özellikler

DataTemplateKey	varsayılan anahtarını DataTemplatealır.
DataType	Bunun DataTemplate hedeflendiği türü alır veya ayarlar.
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğunu alır. (Devralındığı yer: DispatcherObject)
HasContent	Bu şablonun iyileştirilmiş içeriğe sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: FrameworkTemplate)
IsSealed	Bu nesnenin değiştirilemez durumda olup olmadığını belirten bir değer alır. (Devralındığı yer: FrameworkTemplate)
Resources	Bu şablon kapsamında kullanılabilecek kaynak koleksiyonunu alır veya ayarlar. (Devralındığı yer: FrameworkTemplate)
Template	Şablon bir yazıcı tarafından tanımlandığında veya uygulandığında şablon için XAML düğümlerini kaydeden veya oynatan nesneye başvuru alır veya ayarlar. (Devralındığı yer: FrameworkTemplate)
Triggers	Özellik değerleri uygulayan veya bir veya daha fazla koşula göre eylemler gerçekleştiren tetikleyicilerden oluşan bir koleksiyon alır.
VisualTree	Şablonun kök düğümünü alır veya ayarlar. (Devralındığı yer: FrameworkTemplate)

Yöntemler

CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindName(String, FrameworkElement)	Bu şablonda tanımlanan belirtilen adla ilişkilendirilmiş öğeyi bulur. (Devralındığı yer: FrameworkTemplate)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadContent()	Şablonun içeriğini bir nesnenin örneği olarak yükler ve içeriğin kök öğesini döndürür. (Devralındığı yer: FrameworkTemplate)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RegisterName(String, Object)	Geçerli ad kapsamına yeni bir ad/nesne çifti kaydeder. (Devralındığı yer: FrameworkTemplate)
Seal()	Şablonu değiştirilemeyecek şekilde kilitler. (Devralındığı yer: FrameworkTemplate)
ShouldSerializeResources(XamlDesignerSerializationManager)	Serileştirme işlemlerinin bu sınıfın örneklerinde özelliğin Resources değerini seri hale getirip getirmemesi gerektiğini belirten bir değer döndürür. (Devralındığı yer: FrameworkTemplate)
ShouldSerializeVisualTree()	Serileştirme işlemlerinin bu sınıfın örneklerinde özelliğin VisualTree değerini seri hale getirip getirmemesi gerektiğini belirten bir değer döndürür. (Devralındığı yer: FrameworkTemplate)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
UnregisterName(String)	XAML ad kapsamlarından bir ad/nesne eşlemesini kaldırır. (Devralındığı yer: FrameworkTemplate)
ValidateTemplatedParent(FrameworkElement)	Şablonlu üst öğeyi bir dizi kurala göre denetler.
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjecterişimine sahip olmasını zorlar. (Devralındığı yer: DispatcherObject)

Belirtik Arabirim Kullanımları

INameScope.FindName(String)	Sağlanan tanımlayıcı ada sahip bir nesne döndürür. (Devralındığı yer: FrameworkTemplate)
IQueryAmbient.IsAmbientPropertyAvailable(String)	Belirtilen bir ortam özelliğinin geçerli kapsamda kullanılabilir olup olmadığını sorgular. (Devralındığı yer: FrameworkTemplate)

Şunlara uygulanır