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

  new ValidateValueCallback(FrameworkElement.IsWidthHeightValid));
  }

   // Оболочка CLR, реализованная с использованием
   // унаследованных методов GetValue/SetValue.
  public double Height
  {
  get { return (double) base.GetValue(HeightProperty); }
  set { base.SetValue(HeightProperty, value); }
  }
 }

Как видите, по сравнению с обычными свойствами CLR свойства зависимости требуют немалого объема дополнительного кода. В реальности зависимость может оказаться даже еще более сложной, чем показано здесь (к счастью, многие реализации проще свойства Height).

В первую очередь вспомните, что если в классе необходимо определить свойство зависимости, то он должен иметь в своей цепочке наследования DependencyObject, т.к. именно этот класс определяет методы GetValue и SetValue, применяемые в оболочке CLR. Из-за того, что класс FrameworkElement "является" DependencyObject, указанное требование удовлетворено.

Далее вспомните, что сущность, где действительно хранится значение свойства (значение double в случае Height), представляется как открытое, статическое, допускающее только чтение поле типа DependencyProperty. По соглашению имя этого свойства должно всегда формироваться из имени связанной оболочки CLR с добавлением суффикса Property:

 public static readonly DependencyProperty HeightProperty;

Учитывая, что свойства зависимости объявляются как статические поля, они обычно создаются (и регистрируются) внутри статического конструктора класса. Объект DependencyProperty создается посредством вызова статического метода DependencyProperty.Register. Данный метод имеет множество перегруженных версий, но в случае свойства Height он вызывается следующим образом:

 HeightProperty = DependencyProperty.Register(
  "Height",
  typeof(double),
  typeof(FrameworkElement),
  new FrameworkPropertyMetadata((double)0.0,
  FrameworkPropertyMetadataOptions.AffectsMeasure,
  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

Подводя итог, следует отметить, что свойства зависимости выглядят как обычные свойства, когда вы извлекаете или устанавливаете их значения в разметке XAML либо в коде, но "за кулисами" они реализованы с помощью гораздо более замысловатых программных приемов. Вспомните, что основным назначением этого процесса является построение специального элемента управления, имеющего специальные свойства, которые должны быть интегрированы со службами WPF, требующими взаимодействия через свойства зависимости (например, с анимацией, привязкой данных и стилями).