DependencyObject.SetValue(DependencyProperty, Object) Metode

Definisi

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

dp
DependencyProperty

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.

Berlaku untuk

Lihat juga