DependencyObject.CoerceValue(DependencyProperty) Yöntem

Tanım

Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında var olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir CoerceValueCallback işlevi çağırarak DependencyObjectgerçekleştirilir.

C#
public void CoerceValue (System.Windows.DependencyProperty dp);

Parametreler

dp
DependencyProperty

Zorlamak için bağımlılık özelliğinin tanımlayıcısı.

Özel durumlar

Belirtilen dp veya değeri geçersiz veya yok.

Örnekler

Aşağıdaki örnek, aynı sınıftaki farklı bağımlılık özellikleri için olarak PropertyChangedCallback kullanılan bir uygulama içinde PropertyChangedCallback çağrı yaparCoerceValue. Bu, bağımlılık özellikleri arasındaki gerçek değer bağımlılıklarını tanıtmak için yaygın bir desendir.

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

Açıklamalar

çağrısıyla CoerceValueaçıkça çağrılmaya ek olarak, CoerceValueCallback bağımlılık özelliği değeri WPF özellik sistemi tarafından yeniden değerlendirildiğinde bir bağımlılık özelliği için de dahili olarak çağrılır.

yöntemini çağırdığınızda CoerceValue , belirttiğiniz özellik için son olarak coerce değeri geri çağırmayı çağırırsınız. Genellikle yalnızca bir zorlayıcı değer geri çağırmasının mevcut olduğunu biliyorsanız ve geri çağırmanın zorlama ölçütlerini biliyorsanız çağırırsınız CoerceValue .

Çağırma CoerceValue için en yaygın senaryo, sınıf işleme veya birbirinin değerlerini bağımlı bir şekilde etkileyen ilgili özelliklerin özellik değişikliği geri çağırmalarıdır. Daha fazla bilgi için bkz . Bağımlılık Özelliği Geri Çağırmaları ve Doğrulama.

Şunlara uygulanır

Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

Ayrıca bkz.