FrameworkPropertyMetadata.IsNotDataBindable 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 menetapkan nilai yang menunjukkan apakah properti dependensi mendukung pengikatan data.
public:
property bool IsNotDataBindable { bool get(); void set(bool value); };
public bool IsNotDataBindable { get; set; }
member this.IsNotDataBindable : bool with get, set
Public Property IsNotDataBindable As Boolean
Nilai Properti
true jika properti tidak mendukung pengikatan data; jika tidak, false. Defaultnya adalah false.
Pengecualian
Metadata telah diterapkan ke operasi properti dependensi, sehingga metadata disegel dan properti metadata tidak dapat diatur.
Keterangan
Perhatikan bahwa properti metadata ini diatur ke true khusus untuk properti yang seharusnya tidak mendukung pengikatan data, meskipun merupakan properti baca-tulis. Harapannya adalah bahwa dalam kebanyakan kasus di mana properti dependensi dinyatakan, pengikatan data diinginkan, karena pengikatan data adalah salah satu skenario utama di mana properti dependensi berguna. Tidak seperti BindsTwoWayByDefault, ini tidak hanya mengubah default yang nantinya dapat diubah pada pengikatan tertentu. Mengatur properti true ini dalam metadata untuk metadata properti dependensi akan menonaktifkan semua pengikatan agar tidak menerapkan nilainya melalui ekspresi ke properti dependensi tersebut.
Properti dependensi baca-saja tidak mendukung pengikatan data (karena tidak memiliki setter yang dapat menerapkan nilai yang diubah), tetapi masih akan melaporkan false untuk IsNotDataBindable. Ini karena properti yang sesuai dengan FrameworkPropertyMetadataOptions nilai akan melaporkan paritas dengan bagaimana metadata benar-benar dibuat, daripada selalu melaporkan perilaku hasil akhir yang mungkin menyiratkan penamaan properti. Untuk menentukan apakah properti dependensi tertentu mengizinkan pengikatan data, Anda biasanya harus memeriksa IsDataBindingAllowed sebagai gantinya.
IsDataBindingAllowed adalah kenyamanan untuk memeriksa dan ReadOnlyIsNotDataBindable sebagai operasi tunggal, menghasilkan hasil yang diharapkan.
Properti pada kelas turunan PropertyMetadata biasanya didefinisikan dalam model objek sebagai baca-tulis. Hal ini agar dapat disesuaikan setelah inisialisasi instans. Namun, setelah metadata digunakan sebagai bagian dari panggilan ke Register, , AddOwneratau OverrideMetadata, sistem properti akan menyegel instans metadata dan properti yang menyampaikan spesifikasi metadata sekarang dianggap tidak dapat diubah. Mencoba mengatur properti ini setelah IsSealed ada true pada instans metadata ini akan menimbulkan pengecualian.
Penggunaan Teks XAML
Anggota kelas ini biasanya tidak digunakan dalam XAML.