DependencyObject.CoerceValue(DependencyProperty) Metoda

Definice

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

Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje 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ání 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í skutečných hodnot mezi vlastnostmi závislosti 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ě explicitního vyvolání voláním CoerceValue se CoerceValueCallback vlastnosti závislosti vyvolá interně při každém opětovném vyhodnocení hodnoty vlastnosti závislosti systémem vlastností WPF (Windows Presentation Foundation).

Když vyvoláte metodu CoerceValue , 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í zpětného volání zpětného volání coerce existuje, a pokud znáte kritéria zpětného volání pro převod.

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

Platí pro

Viz také