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

Как и "нормальное" свойство .NET Core (которое в литературе, посвященной WPF, часто называют свойством CLR), свойство зависимости можно устанавливать декларативно с помощью разметки XAML или программно в файле кода. Кроме того, свойства зависимости (подобно свойствам CLR) в конечном итоге предназначены для инкапсуляции полей данных класса и могут быть сконфигурированы как доступные только для чтения, только для записи или для чтения и записи.
Вы будете практически всегда пребывать в блаженном неведении относительно того, что фактически устанавливаете (или читаете) свойство зависимости, а не свойство CLR! Например, свойства 
Height
 и 
Width
, которые элементы управления WPF наследуют от класса 
FrameworkElement
, а также член 
Content
, унаследованный от класса 
ControlContent
, на самом деле являются свойствами зависимости:
<b>&lt;!-- Установить три свойства зависимости --&gt;</b>
&lt;Button x:Name = &quot;btnMyButton&quot; Height = &quot;50&quot; Width = &quot;100&quot; Content = &quot;OK&quot;/&gt;
С учетом всех указанных сходств возникает вопрос: зачем нужно было определять в WPF новый термин для такой знакомой концепции? Ответ кроется в способе реализации свойства зависимости внутри класса. Пример кода будет показан позже, а на высоком уровне все свойства зависимости создаются описанным ниже способом.
• Класс, который определяет свойство зависимости, должен иметь в своей цепочке наследования класс 
DependencyObject
.
• Одиночное свойство зависимости представляется как открытое, статическое, допускающее только чтение поле типа 
DependencyProperty
. По соглашению это поле именуется путем снабжения имени оболочки CLR (см. последний пункт списка) суффиксом Property.
• Переменная типа 
DependencyProperty
 регистрируется посредством вызова статического метода 
DependencyProperty.Register()
, который обычно происходит в статическом конструкторе или встраивается в объявление переменной.
• В классе будет определено дружественное к XAML свойство CLR, которое вызывает методы, предоставляемые классом 
DependencyObject
, для получения и установки значения.
После реализации свойства зависимости предлагают несколько мощных инструментов, которые применяются разнообразными технологиями WPF, в том числе привязкой данных, службами анимации, стилями, шаблонами и т.д. Мотивацией создания свойств зависимости было желание предоставить способ вычисления значений свойств на основе значений из других источников. Далее приведен список основных преимуществ, которые выходят далеко за рамки простой инкапсуляции данных, обеспечиваемой свойствами CLR.
• Свойства зависимости могут наследовать свои значения от определения XAML родительского элемента. Например, если в открывающем дескрипторе Window определено значение для атрибута 
FontSize
, то все элементы управления внутри 
Window
 по умолчанию будут иметь тот же самый размер шрифта.
• Свойства зависимости поддерживают возможность получать значения, которые установлены элементами внутри их области определения XAML, например, в случае установки элементом 
Button
 свойства 
Dock
 родительского контейнера 
DockPanel
. (Вспомните, что присоединяемые свойства делают именно это, поскольку являются разновидностью свойств зависимости.)
 
• Свойства зависимости позволяют инфраструктуре WPF вычислять значение на основе множества внешних значений, что может быть важно для служб анимации и привязки данных.
• Свойства зависимости предоставляют поддержку инфраструктуры для триггеров WPF (также довольно часто используемых при работе с анимацией и привязкой данных).
Имейте в виду, что во многих случаях вы будете взаимодействовать с существующим свойством зависимости способом, идентичным работе с обычным свойством CLR (благодаря оболочке CLR). В предыдущем разделе, посвященном привязке данных, вы узнали, что если необходимо установить привязку данных в коде, то должен быть вызван метод 
SetBinding()
 на целевом объекте операции и указано свойство зависимости, с которым будет работать привязка:
private void SetBindings()
{
  Binding b = new Binding
  {
    // Зарегистрировать преобразователь, источник и путь.
    Converter = new MyDoubleConverter(),
    Source = this.mySB,
    Path = new PropertyPath(&quot;Value&quot;)
  };
<b>  // Указать свойство зависимости.</b>
  this.labelSBThumb.SetBinding(Label.ContentProperty, b);
}
Вы увидите похожий код в главе 27 во время исследования запуска анимации в коде:
<b>// Указать свойство зависимости.</b>
rt.BeginAnimation(RotateTransform.AngleProperty, dblAnim);
Потребность в построении специального свойства зависимости возникает только во время разработки собственного элемента управления WPF. Например, когда создается класс 
UserControl
 с четырьмя специальными свойствами, которые должны тесно интегрироваться с API-интерфейсом WPF, они должны быть реализованы с применением логики свойств зависимости.
В частности, если нужно, чтобы свойство было целью операции привязки данных или анимации, если оно обязано уведомлять о своем изменении, если свойство должно быть в состоянии работать в качестве установщика в стиле WPF или получать свои значения от родительского элемента, то возможностей обычного свойства CLR окажется не достаточно. В случае использования обычного свойства другие программисты действительно могут получать и устанавливать его значение, но если они попытаются применить такое свойство внутри контекста службы WPF, то оно не будет работать ожидаемым образом. Поскольку заранее нельзя узнать, как другие пожелают взаимодействовать со свойствами специальных классов 
UserControl
, нужно выработать в себе привычку при построении специальных элементов управления всегда определять свойства зависимости.
  
Исследование существующего свойства зависимости
 
Прежде чем вы научитесь создавать специальные свойства зависимости, давайте рассмотрим внутреннюю реализацию свойства 
Height
 класса 
FrameworkElement
. Ниже приведен соответствующий код (с комментариями):