DependencyPropertyChangedEventArgs.NewValue Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Ruft den Wert der Eigenschaft nach der Änderung ab.

C#

public object NewValue { get; }

Eigenschaftswert

Object

Der Eigenschaftswert nach der Änderung.

Beispiele

Im folgenden Beispiel wird die DependencyPropertyChangedEventArgs -Klasse im Kontext eines PropertyChangedCallback für eine bestimmte Eigenschaft einer benutzerdefinierten Klasse verwendet, die auch Ereignisse definiert. Der Rückruf übernimmt die Ergebnisse alter und neuer Werte aus dem Eigenschaftensystem, wie von DependencyPropertyChangedEventArgskommuniziert, und packt diese in eine andere Ereignisargumentklasse RoutedPropertyChangedEventArgs<T>. Die neuen Argumente werden dann als Daten für ein "ValueChanged"-Ereignis verwendet, das von der benutzerdefinierten Klasse definiert und ausgelöst wird.

C#

public static readonly DependencyProperty ValueProperty =
    DependencyProperty.Register(
        "Value", typeof(decimal), typeof(NumericUpDown),
        new FrameworkPropertyMetadata(MinValue, new PropertyChangedCallback(OnValueChanged),
                                      new CoerceValueCallback(CoerceValue)));

private static object CoerceValue(DependencyObject element, object value)
{
    decimal newValue = (decimal)value;

    newValue = Math.Max(MinValue, Math.Min(MaxValue, newValue));

    return newValue;
}

private static void OnValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
    NumericUpDown control = (NumericUpDown)obj;

    RoutedPropertyChangedEventArgs<decimal> e = new RoutedPropertyChangedEventArgs<decimal>(
        (decimal)args.OldValue, (decimal)args.NewValue, ValueChangedEvent);
    control.OnValueChanged(e);
}
/// <summary>
/// Identifies the ValueChanged routed event.
/// </summary>
public static readonly RoutedEvent ValueChangedEvent = EventManager.RegisterRoutedEvent(
    "ValueChanged", RoutingStrategy.Bubble,
    typeof(RoutedPropertyChangedEventHandler<decimal>), typeof(NumericUpDown));

/// <summary>
/// Occurs when the Value property changes.
/// </summary>
public event RoutedPropertyChangedEventHandler<decimal> ValueChanged
{
    add { AddHandler(ValueChangedEvent, value); }
    remove { RemoveHandler(ValueChangedEvent, value); }
}
/// <summary>
/// Raises the ValueChanged event.
/// </summary>
/// <param name="args">Arguments associated with the ValueChanged event.</param>
protected virtual void OnValueChanged(RoutedPropertyChangedEventArgs<decimal> args)
{
    RaiseEvent(args);
}

Hinweise

Der Typ des angegebenen Werts sollte immer in den Typ der gemeldeten Abhängigkeitseigenschaft umgewandelt werden können.

Gilt für: