Udostępnij za pośrednictwem


Wywołania zwrotne i walidacja właściwości zależności (WPF .NET)

W tym artykule opisano sposób definiowania właściwości zależności i implementowania wywołań zwrotnych właściwości zależności. Wywołania zwrotne obsługują walidację wartości, rzutowanie wartości i inną logikę wymaganą przy zmianie wartości właściwości.

Warunki wstępne

W artykule przyjęto założenie, że masz podstawową wiedzę na temat właściwości zależności i że zapoznałeś się z omówieniem właściwości zależności . Aby postępować zgodnie z przykładami w tym artykule, warto zapoznać się z językiem Extensible Application Markup Language (XAML) i wiedzieć, jak pisać aplikacje WPF.

Funkcje zwrotne walidacji wartości

Procedury zwrotne walidacji wartości umożliwiają sprawdzenie, czy nowa wartość właściwości zależności jest prawidłowa, zanim zostanie zastosowana przez system właściwości. To wywołanie zwrotne zgłasza wyjątek, jeśli wartość nie spełnia kryteriów weryfikacji.

Wywołania zwrotne dla funkcji walidacji można przypisać do właściwości zależności tylko raz, i to podczas jej rejestracji. Podczas rejestrowania właściwości zależności możesz przekazać odwołanie ValidateValueCallback do metody Register(String, Type, Type, PropertyMetadata, ValidateValueCallback). Funkcje zwrotne potwierdzające wartość nie są częścią metadanych właściwości i nie można ich nadpisać.

Efektywną wartością właściwości zależności jest jej zastosowana wartość. Wartość efektywna jest określana według hierarchii wartości właściwości , gdy istnieje wiele danych wejściowych opartych na właściwościach. Jeśli funkcja zwrotna do walidacji wartości jest zarejestrowana dla właściwości zależnej, system właściwości wywoła tę funkcję w przypadku zmiany wartości, przekazując nową wartość jako obiekt. W wywołaniu zwrotnym można rzutować obiekt wartości z powrotem do typu zarejestrowanego w systemie właściwości, a następnie uruchomić logikę walidacji na nim. Funkcja zwrotna zwraca true jeśli wartość jest prawidłowa dla właściwości, w przeciwnym razie false.

Jeśli wywołanie zwrotne funkcji sprawdzającej wartość zwraca false, zgłaszany jest wyjątek i nowa wartość nie zostaje zastosowana. Autorzy aplikacji muszą być przygotowani do obsługi tych wyjątków. Typowym zastosowaniem wywołań zwrotnych sprawdzających wartość jest weryfikacja wartości wyliczeń lub ograniczanie wartości liczbowych, gdy reprezentują one pomiary z ustalonymi granicami. Wywołania zwrotne funkcji walidacji wartości są uruchamiane przez system właściwości w różnych scenariuszach, w tym:

  • Inicjowanie obiektu, które stosuje wartość domyślną w czasie tworzenia.
  • Programistyczne wywołania do SetValue.
  • Nadpisania metadanych określające nową wartość domyślną.

Funkcje zwrotne validate-value nie posiadają parametru określającego instancję DependencyObject, na której ustawiana jest nowa wartość. Wszystkie wystąpienia DependencyObject współużytkują tę samą funkcję zwrotną walidacji wartości, więc nie można jej użyć do walidacji scenariuszy specyficznych dla instancji. Aby uzyskać więcej informacji, zobacz ValidateValueCallback.

W poniższym przykładzie pokazano, jak zapobiec właściwości typu Doubleprzyjmowania wartości PositiveInfinity lub NegativeInfinity.

public class Gauge1 : Control
{
    public Gauge1() : base() { }

    // Register a dependency property with the specified property name,
    // property type, owner type, property metadata, and callbacks.
    public static readonly DependencyProperty CurrentReadingProperty =
        DependencyProperty.Register(
            name: "CurrentReading",
            propertyType: typeof(double),
            ownerType: typeof(Gauge1),
            typeMetadata: new FrameworkPropertyMetadata(
                defaultValue: double.NaN,
                flags: FrameworkPropertyMetadataOptions.AffectsMeasure),
            validateValueCallback: new ValidateValueCallback(IsValidReading));

    // CLR wrapper with get/set accessors.
    public double CurrentReading
    {
        get => (double)GetValue(CurrentReadingProperty);
        set => SetValue(CurrentReadingProperty, value);
    }

    // Validate-value callback.
    public static bool IsValidReading(object value)
    {
        double val = (double)value;
        return !val.Equals(double.NegativeInfinity) && 
            !val.Equals(double.PositiveInfinity);
    }
}
Public Class Gauge1
    Inherits Control

    Public Sub New()
        MyBase.New()
    End Sub

    Public Shared ReadOnly CurrentReadingProperty As DependencyProperty =
        DependencyProperty.Register(
            name:="CurrentReading",
            propertyType:=GetType(Double),
            ownerType:=GetType(Gauge1),
            typeMetadata:=New FrameworkPropertyMetadata(
                defaultValue:=Double.NaN,
                flags:=FrameworkPropertyMetadataOptions.AffectsMeasure),
            validateValueCallback:=New ValidateValueCallback(AddressOf IsValidReading))

    Public Property CurrentReading As Double
        Get
            Return GetValue(CurrentReadingProperty)
        End Get
        Set(value As Double)
            SetValue(CurrentReadingProperty, value)
        End Set
    End Property

    Public Shared Function IsValidReading(value As Object) As Boolean
        Dim val As Double = value
        Return Not val.Equals(Double.NegativeInfinity) AndAlso
            Not val.Equals(Double.PositiveInfinity)
    End Function

End Class
public static void TestValidationBehavior()
{
    Gauge1 gauge = new();

    Debug.WriteLine($"Test value validation scenario:");

    // Set allowed value.
    gauge.CurrentReading = 5;
    Debug.WriteLine($"Current reading: {gauge.CurrentReading}");

    try
    {
        // Set disallowed value.
        gauge.CurrentReading = double.PositiveInfinity;
    }
    catch (ArgumentException e)
    {
        Debug.WriteLine($"Exception thrown by ValidateValueCallback: {e.Message}");
    }

    Debug.WriteLine($"Current reading: {gauge.CurrentReading}");

    // Current reading: 5
    // Exception thrown by ValidateValueCallback: '∞' is not a valid value for property 'CurrentReading'.
    // Current reading: 5
}
Public Shared Sub TestValidationBehavior()
    Dim gauge As New Gauge1()

    Debug.WriteLine($"Test value validation scenario:")

    ' Set allowed value.
    gauge.CurrentReading = 5
    Debug.WriteLine($"Current reading: {gauge.CurrentReading}")

    Try
        ' Set disallowed value.
        gauge.CurrentReading = Double.PositiveInfinity
    Catch e As ArgumentException
        Debug.WriteLine($"Exception thrown by ValidateValueCallback: {e.Message}")
    End Try

    Debug.WriteLine($"Current reading: {gauge.CurrentReading}")

    ' Current reading: 5
    ' Exception thrown by ValidateValueCallback: '∞' is not a valid value for property 'CurrentReading'.
    ' Current reading 5
End Sub

Wywołania zwrotne na zmianę właściwości

Zwrotne wywołania zmiany właściwości informują, gdy zmieni się faktyczna wartość właściwości zależności.

Wywołania zwrotne po zmianie właściwości są częścią metadanych właściwości zależnej. Jeśli dziedziczysz po klasie, która definiuje właściwość zależną, lub dodajesz swoją klasę jako właściciela właściwości zależnej, możesz zastąpić metadane. Podczas zastępowania metadanych możesz podać nową referencję PropertyChangedCallback. Użyj wywołania zwrotnego zmienionej właściwości, aby uruchomić logikę potrzebną w przypadku zmiany wartości właściwości.

W przeciwieństwie do wywołań zwrotnych sprawdzających wartość, wywołania zwrotne zmiany właściwości mają parametr, który określa instancję DependencyObject, na której ustawiono nową wartość. W następnym przykładzie pokazano, w jaki sposób wywołanie zwrotne zmienione przez właściwość może używać odwołania wystąpienia DependencyObject do wyzwalania wywołań zwrotnych coerce-value.

Funkcje zwrotne przekształcania wartości

Wywołania zwrotne coerce-value umożliwiają otrzymywanie powiadomień, gdy efektywna wartość właściwości zależności zostanie zmieniona, aby można było dostosować nową wartość przed jej zastosowaniem. Oprócz tego, że jest uruchamiany przez system właściwości, możesz także wywołać własne funkcje przetwarzania wartości z kodu.

Wywołania zwrotne coerce-value są częścią metadanych właściwości zależności. Jeśli pochodzisz z klasy definiującej właściwość zależności lub dodaj klasę jako właściciela właściwości zależności, możesz zastąpić metadane. Podczas zastępowania metadanych możesz podać odwołanie do nowego CoerceValueCallback. Użyj funkcji zwrotnej wymuszającej wartość, aby oceniać nowe wartości i przekształcać je w razie potrzeby. Wywołanie zwrotne zwraca wartość wymuszoną, jeśli wystąpiło wymuszenie, w przeciwnym razie zwraca niezmienioną nową wartość.

Podobnie jak wywołania zwrotne dla zmiany właściwości, wywołania zwrotne coerce-value mają parametr określający instancję DependencyObject, na której ustawiana jest nowa wartość. W następnym przykładzie pokazano, jak wywołanie zwrotne coerce-value może używać odwołania do instancji DependencyObject w celu przekształcania wartości właściwości.

Notatka

Wartości właściwości domyślnych nie mogą być konercowane. Właściwość zależności ma domyślną wartość ustawioną na inicjowanie obiektu lub w przypadku wyczyszczenia innych wartości przy użyciu ClearValue.

Coerce-value i właściwości zmienione wywołania zwrotne w kombinacji

Zależności między właściwościami elementu można tworzyć, używając w połączeniu wywołań zwrotnych wymuszania wartości oraz wywołań zmiany właściwości. Na przykład zmiany w jednej właściwości wymuszają przymuszenie lub ponowne ocenianie innej właściwości będącej zależnością. W następnym przykładzie przedstawiono typowy scenariusz: trzy właściwości zależności, które odpowiednio przechowują bieżącą wartość, wartość minimalną i maksymalną wartość elementu interfejsu użytkownika. Jeśli wartość maksymalna zmieni się tak, aby była mniejsza niż bieżąca wartość, bieżąca wartość jest następnie ustawiona na nową wartość maksymalną. A jeśli wartość minimalna zmieni się tak, aby była większa niż bieżąca wartość, bieżąca wartość jest następnie ustawiona na nową wartość minimalną. W tym przykładzie PropertyChangedCallback dla bieżącej wartości jawnie wywołuje CoerceValueCallback dla wartości minimalnych i maksymalnych.

public class Gauge2 : Control
{
    public Gauge2() : base() { }

    // Register a dependency property with the specified property name,
    // property type, owner type, property metadata, and callbacks.
    public static readonly DependencyProperty CurrentReadingProperty =
        DependencyProperty.Register(
            name: "CurrentReading",
            propertyType: typeof(double),
            ownerType: typeof(Gauge2),
            typeMetadata: new FrameworkPropertyMetadata(
                defaultValue: double.NaN,
                flags: FrameworkPropertyMetadataOptions.AffectsMeasure,
                propertyChangedCallback: new PropertyChangedCallback(OnCurrentReadingChanged),
                coerceValueCallback: new CoerceValueCallback(CoerceCurrentReading)
            ),
            validateValueCallback: new ValidateValueCallback(IsValidReading)
        );

    // CLR wrapper with get/set accessors.
    public double CurrentReading
    {
        get => (double)GetValue(CurrentReadingProperty);
        set => SetValue(CurrentReadingProperty, value);
    }

    // Validate-value callback.
    public static bool IsValidReading(object value)
    {
        double val = (double)value;
        return !val.Equals(double.NegativeInfinity) && !val.Equals(double.PositiveInfinity);
    }

    // Property-changed callback.
    private static void OnCurrentReadingChanged(DependencyObject depObj, DependencyPropertyChangedEventArgs e)
    {
        depObj.CoerceValue(MinReadingProperty);
        depObj.CoerceValue(MaxReadingProperty);
    }

    // Coerce-value callback.
    private static object CoerceCurrentReading(DependencyObject depObj, object value)
    {
        Gauge2 gauge = (Gauge2)depObj;
        double currentVal = (double)value;
        currentVal = currentVal < gauge.MinReading ? gauge.MinReading : currentVal;
        currentVal = currentVal > gauge.MaxReading ? gauge.MaxReading : currentVal;
        return currentVal;
    }

    // Register a dependency property with the specified property name,
    // property type, owner type, property metadata, and callbacks.
    public static readonly DependencyProperty MaxReadingProperty = DependencyProperty.Register(
        name: "MaxReading",
        propertyType: typeof(double),
        ownerType: typeof(Gauge2),
        typeMetadata: new FrameworkPropertyMetadata(
            defaultValue: double.NaN,
            flags: FrameworkPropertyMetadataOptions.AffectsMeasure,
            propertyChangedCallback: new PropertyChangedCallback(OnMaxReadingChanged),
            coerceValueCallback: new CoerceValueCallback(CoerceMaxReading)
        ),
        validateValueCallback: new ValidateValueCallback(IsValidReading)
    );

    // CLR wrapper with get/set accessors.
    public double MaxReading
    {
        get => (double)GetValue(MaxReadingProperty);
        set => SetValue(MaxReadingProperty, value);
    }

    // Property-changed callback.
    private static void OnMaxReadingChanged(DependencyObject depObj, DependencyPropertyChangedEventArgs e)
    {
        depObj.CoerceValue(MinReadingProperty);
        depObj.CoerceValue(CurrentReadingProperty);
    }

    // Coerce-value callback.
    private static object CoerceMaxReading(DependencyObject depObj, object value)
    {
        Gauge2 gauge = (Gauge2)depObj;
        double maxVal = (double)value;
        return maxVal < gauge.MinReading ? gauge.MinReading : maxVal;
    }

    // Register a dependency property with the specified property name,
    // property type, owner type, property metadata, and callbacks.
    public static readonly DependencyProperty MinReadingProperty = DependencyProperty.Register(
    name: "MinReading",
    propertyType: typeof(double),
    ownerType: typeof(Gauge2),
    typeMetadata: new FrameworkPropertyMetadata(
        defaultValue: double.NaN,
        flags: FrameworkPropertyMetadataOptions.AffectsMeasure,
        propertyChangedCallback: new PropertyChangedCallback(OnMinReadingChanged),
        coerceValueCallback: new CoerceValueCallback(CoerceMinReading)
    ),
    validateValueCallback: new ValidateValueCallback(IsValidReading));

    // CLR wrapper with get/set accessors.
    public double MinReading
    {
        get => (double)GetValue(MinReadingProperty);
        set => SetValue(MinReadingProperty, value);
    }

    // Property-changed callback.
    private static void OnMinReadingChanged(DependencyObject depObj, DependencyPropertyChangedEventArgs e)
    {
        depObj.CoerceValue(MaxReadingProperty);
        depObj.CoerceValue(CurrentReadingProperty);
    }

    // Coerce-value callback.
    private static object CoerceMinReading(DependencyObject depObj, object value)
    {
        Gauge2 gauge = (Gauge2)depObj;
        double minVal = (double)value;
        return minVal > gauge.MaxReading ? gauge.MaxReading : minVal;
    }
}
Public Class Gauge2
    Inherits Control

    Public Sub New()
        MyBase.New()
    End Sub

    ' Register a dependency property with the specified property name,
    ' property type, owner type, property metadata, And callbacks.
    Public Shared ReadOnly CurrentReadingProperty As DependencyProperty =
        DependencyProperty.Register(
            name:="CurrentReading",
            propertyType:=GetType(Double),
            ownerType:=GetType(Gauge2),
            typeMetadata:=New FrameworkPropertyMetadata(
                defaultValue:=Double.NaN,
                flags:=FrameworkPropertyMetadataOptions.AffectsMeasure,
                propertyChangedCallback:=New PropertyChangedCallback(AddressOf OnCurrentReadingChanged),
                coerceValueCallback:=New CoerceValueCallback(AddressOf CoerceCurrentReading)),
            validateValueCallback:=New ValidateValueCallback(AddressOf IsValidReading))

    ' CLR wrapper with get/set accessors.
    Public Property CurrentReading As Double
        Get
            Return GetValue(CurrentReadingProperty)
        End Get
        Set(value As Double)
            SetValue(CurrentReadingProperty, value)
        End Set
    End Property

    ' Validate-value callback.
    Public Shared Function IsValidReading(value As Object) As Boolean
        Dim val As Double = value
        Return Not val.Equals(Double.NegativeInfinity) AndAlso Not val.Equals(Double.PositiveInfinity)
    End Function

    ' Property-changed callback.
    Private Shared Sub OnCurrentReadingChanged(depObj As DependencyObject, e As DependencyPropertyChangedEventArgs)
        depObj.CoerceValue(MinReadingProperty)
        depObj.CoerceValue(MaxReadingProperty)
    End Sub

    ' Coerce-value callback.
    Private Shared Function CoerceCurrentReading(depObj As DependencyObject, value As Object) As Object
        Dim gauge As Gauge2 = CType(depObj, Gauge2)
        Dim currentVal As Double = value
        currentVal = If(currentVal < gauge.MinReading, gauge.MinReading, currentVal)
        currentVal = If(currentVal > gauge.MaxReading, gauge.MaxReading, currentVal)
        Return currentVal
    End Function

    Public Shared ReadOnly MaxReadingProperty As DependencyProperty =
        DependencyProperty.Register(
        name:="MaxReading",
        propertyType:=GetType(Double),
        ownerType:=GetType(Gauge2),
        typeMetadata:=New FrameworkPropertyMetadata(
            defaultValue:=Double.NaN,
            flags:=FrameworkPropertyMetadataOptions.AffectsMeasure,
            propertyChangedCallback:=New PropertyChangedCallback(AddressOf OnMaxReadingChanged),
            coerceValueCallback:=New CoerceValueCallback(AddressOf CoerceMaxReading)),
        validateValueCallback:=New ValidateValueCallback(AddressOf IsValidReading))

    ' CLR wrapper with get/set accessors.
    Public Property MaxReading As Double
        Get
            Return GetValue(MaxReadingProperty)
        End Get
        Set(value As Double)
            SetValue(MaxReadingProperty, value)
        End Set
    End Property

    ' Property-changed callback.
    Private Shared Sub OnMaxReadingChanged(depObj As DependencyObject, e As DependencyPropertyChangedEventArgs)
        depObj.CoerceValue(MinReadingProperty)
        depObj.CoerceValue(CurrentReadingProperty)
    End Sub

    ' Coerce-value callback.
    Private Shared Function CoerceMaxReading(depObj As DependencyObject, value As Object) As Object
        Dim gauge As Gauge2 = CType(depObj, Gauge2)
        Dim maxVal As Double = value
        Return If(maxVal < gauge.MinReading, gauge.MinReading, maxVal)
    End Function

    ' Register a dependency property with the specified property name,
    ' property type, owner type, property metadata, And callbacks.
    Public Shared ReadOnly MinReadingProperty As DependencyProperty =
        DependencyProperty.Register(
        name:="MinReading",
        propertyType:=GetType(Double),
        ownerType:=GetType(Gauge2),
        typeMetadata:=New FrameworkPropertyMetadata(
            defaultValue:=Double.NaN,
            flags:=FrameworkPropertyMetadataOptions.AffectsMeasure,
            propertyChangedCallback:=New PropertyChangedCallback(AddressOf OnMinReadingChanged),
            coerceValueCallback:=New CoerceValueCallback(AddressOf CoerceMinReading)),
        validateValueCallback:=New ValidateValueCallback(AddressOf IsValidReading))

    ' CLR wrapper with get/set accessors.
    Public Property MinReading As Double
        Get
            Return GetValue(MinReadingProperty)
        End Get
        Set(value As Double)
            SetValue(MinReadingProperty, value)
        End Set
    End Property

    ' Property-changed callback.
    Private Shared Sub OnMinReadingChanged(depObj As DependencyObject, e As DependencyPropertyChangedEventArgs)
        depObj.CoerceValue(MaxReadingProperty)
        depObj.CoerceValue(CurrentReadingProperty)
    End Sub

    ' Coerce-value callback.
    Private Shared Function CoerceMinReading(depObj As DependencyObject, value As Object) As Object
        Dim gauge As Gauge2 = CType(depObj, Gauge2)
        Dim minVal As Double = value
        Return If(minVal > gauge.MaxReading, gauge.MaxReading, minVal)
    End Function

End Class

Zaawansowane scenariusze wywołania zwrotnego

Ograniczenia i żądane wartości

Jeśli lokalnie ustawiona wartość właściwości zależności zostanie zmieniona za pomocą przymusu, niezmieniona lokalnie ustawiona wartość zostanie zachowana jako żądana wartość . Jeśli wymuszenie jest oparte na innych wartościach właściwości, system właściwości będzie dynamicznie ponownie oceniał wymuszenie za każdym razem, gdy te inne wartości się zmienią. W ramach ograniczeń przymusu system właściwości zastosuje wartość znajdującą się najbliżej żądanej wartości. Jeśli warunek przymusu nie będzie już stosowany, system właściwości przywróci żądaną wartość, pod warunkiem że nie jest aktywna żadna wartość o wyższym priorytecie . Poniższy przykład testuje przymus w bieżącym scenariuszu wartości, wartości minimalnej i maksymalnej wartości.

public static void TestCoercionBehavior()
{
    Gauge2 gauge = new()
    {
        // Set initial values.
        MinReading = 0,
        MaxReading = 10,
        CurrentReading = 5
    };

    Debug.WriteLine($"Test current/min/max values scenario:");

    // Current reading is not coerced.
    Debug.WriteLine($"Current reading: " +
        $"{gauge.CurrentReading} (min: {gauge.MinReading}, max: {gauge.MaxReading})");

    // Current reading is coerced to max value.
    gauge.MaxReading = 3;
    Debug.WriteLine($"Current reading: " +
        $"{gauge.CurrentReading} (min: {gauge.MinReading}, max: {gauge.MaxReading})");

    // Current reading is coerced, but tracking back to the desired value.
    gauge.MaxReading = 4;
    Debug.WriteLine($"Current reading: " +
        $"{gauge.CurrentReading} (min: {gauge.MinReading}, max: {gauge.MaxReading})");

    // Current reading reverts to the desired value.
    gauge.MaxReading = 10;
    Debug.WriteLine($"Current reading: " +
        $"{gauge.CurrentReading} (min: {gauge.MinReading}, max: {gauge.MaxReading})");

    // Current reading remains at the desired value.
    gauge.MinReading = 5;
    gauge.MaxReading = 5;
    Debug.WriteLine($"Current reading: " +
        $"{gauge.CurrentReading} (min: {gauge.MinReading}, max: {gauge.MaxReading})");

    // Current reading: 5 (min=0, max=10)
    // Current reading: 3 (min=0, max=3)
    // Current reading: 4 (min=0, max=4)
    // Current reading: 5 (min=0, max=10)
    // Current reading: 5 (min=5, max=5)
}
Public Shared Sub TestCoercionBehavior()

    ' Set initial values.
    Dim gauge As New Gauge2 With {
        .MinReading = 0,
        .MaxReading = 10,
        .CurrentReading = 5
    }

    Debug.WriteLine($"Test current/min/max values scenario:")

    ' Current reading is not coerced.
    Debug.WriteLine($"Current reading: " &
        $"{gauge.CurrentReading} (min={gauge.MinReading}, max={gauge.MaxReading})")

    ' Current reading is coerced to max value.
    gauge.MaxReading = 3
    Debug.WriteLine($"Current reading: " &
        $"{gauge.CurrentReading} (min={gauge.MinReading}, max={gauge.MaxReading})")

    ' Current reading is coerced, but tracking back to the desired value.
    gauge.MaxReading = 4
    Debug.WriteLine($"Current reading: " &
        $"{gauge.CurrentReading} (min={gauge.MinReading}, max={gauge.MaxReading})")

    ' Current reading reverts to the desired value.
    gauge.MaxReading = 10
    Debug.WriteLine($"Current reading: " &
        $"{gauge.CurrentReading} (min={gauge.MinReading}, max={gauge.MaxReading})")

    ' Current reading remains at the desired value.
    gauge.MinReading = 5
    gauge.MaxReading = 5
    Debug.WriteLine($"Current reading: " &
        $"{gauge.CurrentReading} (min={gauge.MinReading}, max={gauge.MaxReading})")

    ' Current reading: 5 (min=0, max=10)
    ' Current reading: 3 (min=0, max=3)
    ' Current reading: 4 (min=0, max=4)
    ' Current reading: 5 (min=0, max=10)
    ' Current reading: 5 (min=5, max=5)
End Sub

Dość złożone scenariusze zależności mogą wystąpić, gdy istnieje wiele właściwości, które są zależne od siebie w sposób cykliczny. Technicznie nie ma nic złego w przypadku złożonych zależności — z tą różnicą, że duża liczba ponownych ocen może zmniejszyć wydajność. Ponadto złożone zależności, które są widoczne w interfejsie użytkownika, mogą mylić użytkowników. Traktuj PropertyChangedCallback i CoerceValueCallback tak jednoznacznie, jak to możliwe, i nie ograniczaj się nadmiernie.

Anulowanie zmian wartości

Zwracając UnsetValue z CoerceValueCallback, można odrzucić zmianę wartości właściwości. Ten mechanizm jest przydatny, gdy zmiana wartości właściwości jest inicjowana asynchronicznie, ale zastosowanie tego mechanizmu nie jest już prawidłowe dla bieżącego stanu obiektu. Innym scenariuszem może być selektywne pomijanie zmiany wartości w zależności od tego, skąd pochodzi. W poniższym przykładzie CoerceValueCallback wywołuje metodę GetValueSource, która zwraca strukturę ValueSource z wyliczeniem BaseValueSource identyfikującym źródło nowej wartości.

// Coerce-value callback.
private static object CoerceCurrentReading(DependencyObject depObj, object value)
{
    // Get value source.
    ValueSource valueSource = 
        DependencyPropertyHelper.GetValueSource(depObj, CurrentReadingProperty);

    // Reject any property value change that's a locally set value.
    return valueSource.BaseValueSource == BaseValueSource.Local ? 
        DependencyProperty.UnsetValue : value;
}
' Coerce-value callback.
Private Shared Function CoerceCurrentReading(depObj As DependencyObject, value As Object) As Object
    ' Get value source.
    Dim valueSource As ValueSource =
        DependencyPropertyHelper.GetValueSource(depObj, CurrentReadingProperty)

    ' Reject any property value that's a locally set value.
    Return If(valueSource.BaseValueSource = BaseValueSource.Local, DependencyProperty.UnsetValue, value)
End Function

Zobacz też