ContentPropertyAttribute Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Markup

Menunjukkan properti jenis mana yang merupakan properti konten XAML. Prosesor XAML menggunakan informasi ini saat memproses elemen anak XAML dari representasi XAML dari jenis yang diatribusikan.

public ref class ContentPropertyAttribute sealed : Attribute

/// [Windows.Foundation.Metadata.AttributeUsage(System.AttributeTargets.RuntimeClass)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.AttributeName("contentproperty")]
class ContentPropertyAttribute final : Attribute

[Windows.Foundation.Metadata.AttributeUsage(System.AttributeTargets.RuntimeClass)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.AttributeName("contentproperty")]
public sealed class ContentPropertyAttribute : Attribute

Public NotInheritable Class ContentPropertyAttribute
Inherits Attribute

Warisan

Attribute

ContentPropertyAttribute

Atribut

AttributeUsageAttribute ContractVersionAttribute AttributeNameAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

C++/WinRT. Lihat atribut [contentproperty].

Atribut ini digunakan untuk mengidentifikasi bahwa properti tertentu dari jenis yang diatribusikan harus dianggap sebagai properti konten XAML, ketika ditafsirkan oleh parser XAML dan kode kerangka kerja XAML lainnya. Tujuan dari properti konten XAML adalah menyediakan singkatan sintaks XAML yang dapat menghilangkan markup elemen properti untuk properti tersebut. Penghapusan elemen properti memfasilitasi bentuk induk-anak yang lebih alami dalam markup XAML. Untuk informasi selengkapnya tentang properti konten XAML, lihat bagian "properti konten XAML" dari panduan sintaks XAML.

Contoh kelas dalam kosakata XAML Windows Runtime default yang menerapkan ContentPropertyAttribute adalah Panel. Properti Turunan pada Panel diidentifikasi sebagai properti konten XAML seperti yang didefinisikan oleh ContentPropertyAttribute dan nilai Namanya . Informasi properti konten diwariskan oleh semua jenis Panel turunan, seperti Kisi dan Kanvas dan StackPanel.

Kode ini memperkirakan bagaimana Panel menerapkan ContentPropertyAttribute di C# (definisi sebenarnya diterapkan dalam kode asli, ini hanya untuk ilustrasi):

[ContentProperty(Name = "Children")]
    public class Panel : FrameworkElement
    { ...}

Menggunakan Panel dan kelas turunannya StackPanel sebagai ilustrasi konsep properti konten XAML, Anda mungkin memiliki XAML berikut:

<StackPanel>
  <StackPanel.Children>
    <TextBlock>Testing content attribute</TextBlock>
  </StackPanel.Children>
</StackPanel>

Hal di atas setara dengan XAML yang lebih mudah dibaca ini:

<StackPanel>
  <TextBlock>Testing content attribute</TextBlock>
</StackPanel>

Ketika diurai oleh parser XAML, pengurai tahu melalui ContentPropertyAttribute yang diterapkan pada Panel bahwa konten apa pun yang ditemukan dalam isi tag StackPanel harus digunakan untuk mengatur nilai Children pada instans StackPanel yang dibuat.

Contoh menonjol lain dari ContentPropertyAttribute dalam tindakan dapat dilihat di kelas TextBlock . TextBlock menggunakan Sebaris sebagai properti kontennya, dan Eksekusi kelas sebaris default menggunakan Teks sebagai properti kontennya. Dalam kombinasi, properti konten memungkinkan sintaks sebaris sederhana seperti <TextBlock>Hello</TextBlock>, meskipun grafik objek yang dibuat oleh XAML ini lebih kompleks dan juga mampu mendukung beberapa elemen sebaris eksplisit jika diinginkan.

Konstruktor

ContentPropertyAttribute()

Menginisialisasi instans baru kelas ContentPropertyAttribute .

Bidang

Name	Menunjukkan properti jenis mana yang merupakan properti konten XAML. Prosesor XAML menggunakan informasi ini saat memproses elemen anak XAML dari representasi XAML dari jenis yang diatribusikan.

Lihat juga

• Attribut
• Panduan sintaks XAML
• Gambaran umum XAML