DependencyObject.CoerceValue(DependencyProperty) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
WindowsBase.dll

Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu 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

Identyfikator właściwości zależności do przymusu.

Wyjątki

InvalidOperationException

Określona dp lub jego wartość była nieprawidłowa lub nie istnieje.

Przykłady

Poniższy przykład wywołuje CoerceValue w PropertyChangedCallback implementacji, która jest używana jako PropertyChangedCallback dla różnych właściwości zależności w tej samej klasie. Jest to typowy wzorzec wprowadzania rzeczywistych zależności wartości między właściwościami zależności.

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

Uwagi

Oprócz jawnego wywoływania przez wywołanie CoerceValuemetody , CoerceValueCallback właściwość dla zależności jest również wywoływana wewnętrznie, gdy wartość właściwości zależności jest ponownie obliczana przez system właściwości WPF.

Wywołanie CoerceValue metody ostatecznie wywołuje wywołanie zwrotne wartości coerce dla określonej właściwości. Zazwyczaj wywołanie jest wywoływane CoerceValue tylko wtedy, gdy wiadomo, że istnieje wywołanie zwrotne wartości przymusu i jeśli znasz kryteria wywołania zwrotnego dla przymusu.

Najczęstszym scenariuszem wywoływania CoerceValue jest obsługa klas lub wywołania zwrotne zmian właściwości powiązanych, które wpływają na wartości siebie w sposób zależny. Aby uzyskać więcej informacji, zobacz Wywołania zwrotne właściwości zależności i walidacja.

Dotyczy

Zobacz też