DataTemplate.DataType Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur jenis yang DataTemplate dimaksudkan ini.
public:
property System::Object ^ DataType { System::Object ^ get(); void set(System::Object ^ value); };
public object DataType { get; set; }
[System.Windows.Markup.Ambient]
public object DataType { get; set; }
member this.DataType : obj with get, set
[<System.Windows.Markup.Ambient>]
member this.DataType : obj with get, set
Public Property DataType As Object
Nilai Properti
Nilai defaultnya adalah null.
- Atribut
Keterangan
Properti ini sangat mirip TargetType dengan properti Style kelas . Saat Anda mengatur properti ini ke jenis data tanpa menentukan x:Key, akan diterapkan secara otomatis ke objek data dari jenis tersebut DataTemplate . Perhatikan bahwa ketika Anda melakukannya x:Key , diatur secara implisit. Oleh karena itu, jika Anda menetapkan nilai DataTemplate ke x:Key, Anda mengesampingkan x:Key yang implisit sehingga DataTemplate tidak akan diterapkan secara otomatis.
Perhatikan juga bahwa jika Anda mengikat ContentControl ke kumpulan Task objek, ContentControl tidak menggunakan DataTemplate secara otomatis. Ini karena pengikatan pada ContentControl membutuhkan informasi lebih lanjut untuk membedakan apakah Anda ingin mengikat seluruh koleksi atau objek individual. Jika ContentControl Anda melacak pilihan jenis ItemsControl, Anda dapat mengatur properti Path pengikatan ContentControl ke "/" untuk menunjukkan bahwa Anda tertarik dengan item saat ini. Misalnya, lihat Cara: Mengikat ke Koleksi dan Menampilkan Informasi Berdasarkan Pilihan. Jika tidak, Anda perlu menentukan DataTemplate secara eksplisit dengan mengatur properti ContentTemplate.
Properti DataType sangat berguna ketika Anda memiliki CompositeCollection berbagai jenis objek data.
Jika properti ini menargetkan elemen XML yang tidak ada di namespace default, Anda harus mendahului nama elemen dengan namespace layanan atau penanda namespace. Untuk XML yang diekspos melalui LINQ untuk XML, namespace muncul dalam kurung kurawal, didahului oleh urutan escape kurung kurawal:
<DataTemplate DataType="{}{http://myNamespace}Details">
Untuk XML yang diekspos melalui XPath, nama elemen didahului oleh perancang namespace yang dibuat oleh instans XmlNamespaceMapping:
<DataTemplate DataType="mn:Details">
Penggunaan Atribut XAML
<object DataType="typeName"/>
Nilai XAML
typeName Jika templat ditujukan untuk data objek, properti ini berisi nama jenis objek data (sebagai string). Untuk merujuk ke nama jenis kelas, gunakan x:Type Markup Extension. Jika templat ditujukan untuk data XML, properti ini berisi nama elemen XML. Lihat keterangan dokumentasi untuk detail tentang menentukan namespace layanan non-default untuk elemen XML.