DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metode
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.
Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa.
protected:
virtual void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);protected virtual void OnPropertyChanged(System.Windows.DependencyPropertyChangedEventArgs e);abstract member OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unitProtected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parameter
Data peristiwa yang akan berisi pengidentifikasi properti dependensi yang menarik, metadata properti untuk jenis tersebut, dan nilai lama dan baru.
Keterangan
Metode ini tidak dimaksudkan untuk secara umum mendeteksi perubahan properti individual atau melakukan pembatalan properti per kasus. OnPropertyChanged sebaliknya ditujukan untuk modifikasi pola pembatalan umum, jika informasi tertentu diketahui tentang klasifikasi properti yang luas. Misalnya, perubahan dalam Freezable mungkin perubahan dalam jenis Freezablenilai , atau mungkin subproperti, di mana perubahan berada dalam referensi lain Freezable . Implementasi Freezable penimpaan OnPropertyChanged menggunakan informasi internal untuk menentukan apakah properti adalah subproperti, dan menyediakan logika kelas dasar yang sesuai untuk kedua kasus.
OnPropertyChanged berpotensi dipanggil berkali-kali selama kehidupan objek. Oleh karena itu, Anda dapat mencapai performa yang lebih baik untuk sistem properti keseluruhan jika Anda mengambil alih metadata properti tertentu lalu melampirkan CoerceValueCallback atau PropertyChangedCallback berfungsi untuk properti individual. Namun, Anda akan menggunakan metode ini jika DependencyObject menyertakan sejumlah besar properti dependensi yang saling terkait nilai, atau jika menyertakan logika seperti perilaku penyajian yang harus dijalankan ulang untuk beberapa kasus terkait dari pembatalan properti.
Catatan Bagi Inheritor
Selalu panggil implementasi dasar. Kegagalan untuk melakukan ini akan secara signifikan menonaktifkan seluruh sistem properti WPF, menyebabkan nilai yang salah dilaporkan.
