DependencyObject.CoerceValue(DependencyProperty) Metode

Definisi

Ruang nama:
System.Windows
Rakitan:
WindowsBase.dll

Memaksa nilai properti dependensi yang ditentukan. Ini dilakukan dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject.

public:
 void CoerceValue(System::Windows::DependencyProperty ^ dp);
public void CoerceValue(System.Windows.DependencyProperty dp);
member this.CoerceValue : System.Windows.DependencyProperty -> unit
Public Sub CoerceValue (dp As DependencyProperty)

Parameter

dp
DependencyProperty

Pengidentifikasi untuk properti dependensi untuk memaksa.

Pengecualian

InvalidOperationException

Nilai yang ditentukan dp atau tidak valid atau tidak ada.

Contoh

Contoh berikut memanggil CoerceValue dalam PropertyChangedCallback implementasi yang digunakan sebagai PropertyChangedCallback untuk properti dependensi yang berbeda pada kelas yang sama. Ini adalah pola umum untuk memperkenalkan dependensi nilai sejati antara properti dependensi.

private static void OnCurrentReadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
  d.CoerceValue(MinReadingProperty);
  d.CoerceValue(MaxReadingProperty);
}

Private Shared Sub OnCurrentReadingChanged(ByVal d As DependencyObject, ByVal e As DependencyPropertyChangedEventArgs)
    d.CoerceValue(MinReadingProperty)
    d.CoerceValue(MaxReadingProperty)
End Sub

Keterangan

Selain secara eksplisit dipanggil melalui panggilan CoerceValue, CoerceValueCallback untuk properti dependensi juga dipanggil secara internal setiap kali nilai properti dependensi dievaluasi kembali oleh sistem properti WPF.

Ketika Anda memanggil CoerceValue metode , Anda pada akhirnya memanggil panggilan balik nilai koerce untuk properti yang Anda tentukan. Biasanya Anda akan memanggil CoerceValue hanya jika Anda tahu bahwa ada panggilan balik nilai koersi, dan jika Anda mengetahui kriteria panggilan balik untuk paksaan.

Skenario paling umum untuk panggilan CoerceValue adalah dalam penanganan kelas atau panggilan balik perubahan properti properti terkait yang memengaruhi nilai satu sama lain dengan cara dependen. Untuk informasi selengkapnya, lihat Panggilan Balik dan Validasi Properti Dependensi.

Berlaku untuk

Lihat juga