DependencyProperty.UnsetValue Bidang
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.
Menentukan nilai statis yang digunakan oleh sistem properti WPF daripada null
menunjukkan bahwa properti ada, tetapi tidak memiliki nilai yang ditetapkan oleh sistem properti.
public: static initonly System::Object ^ UnsetValue;
public static readonly object UnsetValue;
staticval mutable UnsetValue : obj
Public Shared ReadOnly UnsetValue As Object
Nilai Bidang
Keterangan
UnsetValue adalah nilai sentinel yang digunakan untuk skenario di mana sistem properti WPF tidak dapat menentukan nilai yang diminta DependencyProperty .
UnsetValue digunakan daripada null
, karena null
bisa menjadi nilai properti yang valid, serta yang valid (dan sering digunakan) DefaultValue.
UnsetValue tidak pernah dikembalikan dari DependencyObject.GetValue. Saat Anda memanggil DependencyObject.GetValue properti dependensi pada DependencyObject instans, salah satu hal berikut ini berlaku:
Properti dependensi memiliki nilai default yang ditetapkan dalam metadata dan nilai tersebut dikembalikan. Nilai ini mungkin berasal dari DefaultMetadata.
Beberapa nilai lain ditetapkan oleh sistem properti, dan nilai default tidak lagi relevan. Untuk detailnya, lihat Prioritas Nilai Properti Dependensi.
DefaultValue Pengaturan dari UnsetValue secara khusus tidak diizinkan.
DependencyObject.ReadLocalValue UnsetValue mengembalikan ketika properti yang diminta belum diatur secara lokal.
UnsetValue memiliki arti khusus saat digunakan sebagai nilai pengembalian dari CoerceValueCallback. Untuk detailnya, lihat Panggilan Balik dan Validasi Properti Dependensi.
Jika Anda mengikat ke database, perhatikan bahwa UnsetValue tidak setara dengan Value, dengan cara yang sama dengan bagaimana Value tidak setara dengan true null.