DependencyObject.CoerceValue(DependencyProperty) Metoda

  • Reference

Definice

Obor názvů:
System.Windows
Sestavení:
WindowsBase.dll

Převede hodnotu zadané vlastnosti závislosti. To se provádí vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání 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)

Parametry

dp
DependencyProperty

Identifikátor vlastnosti závislosti, která se má provést.

Výjimky

InvalidOperationException

Zadaná dp nebo jeho hodnota byla neplatná nebo neexistuje.

Příklady

Následující příklad volá CoerceValue v rámci PropertyChangedCallback implementace, která se používá jako PropertyChangedCallback pro různé vlastnosti závislostí ve stejné třídě. Jedná se o běžný vzor pro zavedení závislostí true value mezi vlastnostmi závislostí.

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

Poznámky

Kromě toho, že je explicitně vyvolána voláním CoerceValue, CoerceValueCallback vlastnost závislosti se také vyvolá interně při každém opětovném vyhodnocení hodnoty vlastnosti závislostí systémem vlastností WPF.

Při vyvolání CoerceValue metody nakonec vyvoláte zpětné volání hodnoty coerce pro vlastnost, kterou zadáte. Obvykle vyvoláte CoerceValue pouze v případě, že víte, že zpětné volání hodnoty spoluvytválení existuje, a pokud znáte kritéria zpětného volání pro spolupracovníky.

Nejběžnějším scénářem volání je zpracování tříd nebo změna zpětného volání CoerceValue zpětného volání souvisejících vlastností, které ovlivňují hodnoty jednotlivých ostatních závislým způsobem. Další informace najdete v tématu Zpětné volání vlastností závislostí a ověřování.

Platí pro

Viz také