DependencyObject.CoerceValue(DependencyProperty) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Identyfikator właściwości zależności do przymusu.
Wyjątki
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.