Язык программирования C#9 и платформа .NET5

    new PropertyChangedCallback(FrameworkElement.OnTransformDirty)),

  new ValidateValueCallback(FrameworkElement.IsWidthHeightValid));

Первым аргументом, передаваемым методу DependencyProperty.Register, является имя обычного свойства CLR класса (Height), а второй аргумент содержит информацию о типе данных, который его инкапсулирует (double). Третий аргумент указывает информацию о типе класса, которому принадлежит свойство (FrameworkElement). Хотя такие сведения могут показаться избыточными (в конце концов, поле HeightProperty уже определено внутри класса FrameworkElement), это довольно продуманный аспект WPF, поскольку он позволяет одному классу регистрировать свойства в другом классе (даже если его определение было запечатано).

Четвертый аргумент, передаваемый методу DependencyProperty.Register в рассмотренном примере, представляет собой то, что действительно делает свойства зависимости уникальными. Здесь передается объект FrameworkPropertyMetadata, который описывает разнообразные детали относительно того, как инфраструктура WPF должна обрабатывать данное свойство в плане уведомлений с помощью обратных вызовов (если свойству необходимо извещать других, когда его значение изменяется). Кроме того, объект FrameworkPropertyMetadata указывает различные параметры (представленные перечислением FrameworkPropertyMetadataOptions), которые управляют тем, на что свойство воздействует (работает ли оно с привязкой данных, может ли наследоваться и т.д.). В данном случае аргументы конструктора FrameworkPropertyMetadata можно описать так:

new FrameworkPropertyMetadata(

  // Стандартное значение свойства.

  (double)0.0,

  // Параметры метаданных.

  FrameworkPropertyMetadataOptions.AffectsMeasure,

  // Делегат, который указывает на метод,

  // вызываемый при изменении свойства.

  new PropertyChangedCallback(FrameworkElement.OnTransformDirty)

)

Поскольку последний аргумент конструктора FrameworkPropertyMetadata является делегатом, обратите внимание, что он указывает на статический метод OnTransformDirty класса FrameworkElement. Код метода OnTransformDirty здесь не приводится, но имейте в виду, что при создании специального свойства зависимости всегда можно указывать делегат PropertyChangeCallback, нацеленный на метод, который будет вызываться в случае изменения значения свойства.

Это подводит к финальному параметру метода DependencyProperty.Register — второму делегату типа ValidateValueCallback, указывающему на метод класса FrameworkElement, который вызывается для проверки достоверности значения, присваиваемого свойству:

new ValidateValueCallback(FrameworkElement.IsWidthHeightValid)

Метод IsWidthHeightValid содержит логику, которую обычно ожидают найти в блоке установки значения свойства (как более подробно объясняется в следующем разделе):

private static bool IsWidthHeightValid(object value)

{

  double num = (double) value;

  return ((!DoubleUtil.IsNaN(num) && (num >= 0.0))

    && !double.IsPositiveInfinity(num));

}

После того, как объект DependencyProperty зарегистрирован, остается упаковать поле в обычное свойство CLR (Height в рассматриваемом случае). Тем не менее, обратите внимание, что блоки get и set не просто возвращают или устанавливают значение double переменной-члена уровня класса, а делают это косвенно с использованием методов GetValue и SetValue базового класса System.Windows.DependencyObject:

public double Height

{

  get { return (double) base.GetValue(HeightProperty); }

  set { base.SetValue(HeightProperty, value); }

}

Важные замечания относительно оболочек свойств CLR