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

<b>// FrameworkElement &quot;является&quot; DependencyObject.</b>
public class FrameworkElement : UIElement, IFrameworkInputElement,
  IInputElement, ISupportInitialize, IHaveResources, IQueryAmbient
{
  ...
<b>  // Статическое поле только для чтения типа DependencyProperty.</b>
  public static readonly DependencyProperty HeightProperty;
<b>  // Поле DependencyProperty часто регистрируется</b>
<b>  // в статическом конструкторе класса.</b>
  static FrameworkElement()
  {
    ...
    HeightProperty = DependencyProperty.Register(
      &quot;Height&quot;,
      typeof(double),
      typeof(FrameworkElement),
      new FrameworkPropertyMetadata((double) 1.0 / (double) 0.0,
        FrameworkPropertyMetadataOptions.AffectsMeasure,
        new PropertyChangedCallback(FrameworkElement.OnTransformDirty)),
      new ValidateValueCallback(FrameworkElement.IsWidthHeightValid));
    }
<b>    // Оболочка CLR, реализованная с использованием</b>
<b>    // унаследованных методов GetValue()/SetValue().</b>
    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(
  &quot;Height&quot;,
  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,
  // Делегат, который указывает на метод,
  // вызываемый при изменении свойства.