DependencyObject.SetValue(DependencyProperty, Object) 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.
Mengatur nilai lokal properti dependensi pada DependencyObject.
public:
virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;void SetValue(DependencyProperty const& dp, IInspectable const& value);public void SetValue(DependencyProperty dp, object value);function setValue(dp, value)Public Sub SetValue (dp As DependencyProperty, value As Object)Parameter
Pengidentifikasi properti dependensi yang akan diatur.
- value
-
Object
Platform::Object
IInspectable
Nilai lokal baru.
Keterangan
Jika jenis nilai yang disediakan tidak cocok dengan jenis yang dideklarasikan untuk properti dependensi karena awalnya terdaftar, pengecualian akan dilemparkan.
Tidak semua properti Windows Runtime seperti yang digunakan oleh XAML adalah properti dependensi. Pengidentifikasi DependencyProperty harus ada dan harus tersedia sebagai properti publik dari objek pemilik, biasanya objek yang mendaftarkan properti.
Untuk kode pengguna aplikasi, memanggil SetValue biasanya tidak diperlukan. Biasanya, properti dependensi Windows Runtime atau properti dependensi kustom memiliki properti konvensional yang membungkusnya, dan Anda hanya dapat mengatur nilai properti melalui penggunaan titik-titik konvensional. Kasus di mana Anda mungkin masih menggunakan SetValue adalah:
- Anda menentukan properti dependensi kustom. Anda akan memanggil SetValue sebagai bagian dari menentukan pengakses set properti Anda sendiri untuk penggunaan properti konvensional. Untuk informasi selengkapnya, lihat Properti dependensi kustom.
- Anda menentukan panggilan balik atau berada di beberapa cakupan lain di mana Anda sudah diteruskan pengidentifikasi DependencyProperty , dan ada kemungkinan bahwa ada lebih dari satu properti dependensi yang mungkin ingin Anda berinteraksi dalam cakupan tersebut. Dalam kasus ini, mungkin lebih mudah untuk memanggil SetValue, meneruskan pengidentifikasi.