DataContextChangedEventArgs Kelas
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.
Menyediakan data untuk peristiwa DataContextChanged .
public ref class DataContextChangedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataContextChangedEventArgs final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataContextChangedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataContextChangedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataContextChangedEventArgs
Public NotInheritable Class DataContextChangedEventArgs
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Keterangan
Properti FrameworkElement.DataContext memiliki perilaku bawaan di mana nilainya mewarisi semua elemen turunan FrameworkElement dari FrameworkElement tempat nilai DataContext ditetapkan. Perilaku ini memungkinkan sekumpulan elemen terkait untuk menggunakan konteks yang sama untuk mengikat properti sumber yang berbeda, yang sangat berguna untuk templat item, templat data, dan skenario pengikatan data lainnya. Karena DataContext mewarisi, ada potensi untuk setiap FrameworkElement yang menggunakan nilai yang diwariskan untuk mengaktifkan peristiwa DataContextChanged lain. Peristiwa itu bersumber dari elemen pewarisan, bukan elemen induk, setelah elemen mendeteksi bahwa nilai DataContext yang diwariskan telah berubah. Jika Anda tidak menginginkan perilaku ini, Anda harus menangani peristiwa DataContextChanged di sumber induk, tempat peristiwa akan terjadi terlebih dahulu. Sebagai bagian dari logika handler Anda, atur nilai properti Yang Ditangani di data peristiwa DataContextChangedEventArgs ke true. Tindakan itu akan mencegah peristiwa dari perutean ke elemen anak.
Catatan
DataContextChanged memiliki perilaku perutean tetapi bukan peristiwa rute sejati (tidak memiliki pengidentifikasi RoutedEvent ). Selain itu, rute rute dari induk ke anak sedangkan rute peristiwa rute sejati dari anak ke induk. Jika Anda terbiasa dengan Windows Presentation Foundation (WPF), DataContextChanged mungkin dianggap sebagai peristiwa perutean penerowongan oleh definisi perutean peristiwa Windows Presentation Foundation (WPF).
Properti
Handled |
Mendapatkan atau menetapkan nilai yang memengaruhi apakah peristiwa DataContextChanged lain harus dipicu dari elemen anak yang mewarisi nilai DataContext dan mendeteksi bahwa nilai telah berubah. |
NewValue |
Mendapatkan nilai DataContext baru untuk elemen tempat peristiwa DataContextChanged diaktifkan. |