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

  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, требующими взаимодействия через свойства зависимости (например, с анимацией, привязкой данных и стилями).
Несмотря на то что часть реализации свойства зависимости предусматривает определение оболочки CLR, вы никогда не должны помещать логику проверки достоверности в блок set. К тому же оболочка CLR свойства зависимости не должна делать ничего кроме вызовов 
GetValue()
 или 
SetValue()
.
 
Исполняющая среда WPF сконструирована таким образом, что если написать разметку XAML, которая выглядит как установка свойства, например:
<Button x:Name="myButton" Height="100" .../>
то исполняющая среда вообще обойдет блок установки свойства 
Height
 и напрямую вызовет метод 
SetValue()
! Причина такого необычного поведения связана с простым приемом оптимизации. Если бы исполняющая среда WPF обращалась к блоку установки свойства 
Height
, то ей пришлось бы во время выполнения выяснять посредством рефлексии, где находится поле 
DependencyProperty
 (указанное в первом аргументе 
SetValue()
), ссылаться на него в памяти и т.д. То же самое остается справедливым и при написании разметки XAML, которая извлекает значение свойства 
Height
 — метод 
GetValue()
 будет вызываться напрямую. Но раз так, тогда зачем вообще строить оболочку CLR? Дело в том, что XAML в WPF не позволяет вызывать функции в разметке, поэтому следующий фрагмент приведет к ошибке:
<!-- Ошибка! Вызывать методы в XAML-разметке WPF нельзя! -->
<Button x:Name="myButton" this.SetValue("100") .../>
На самом деле установку или получение значения в разметке с применением оболочки CLR следует считать способом сообщения исполняющей среде WPF о необходимости вызова методов 
GetValue()/SetValue()
, т.к. напрямую вызывать их в разметке невозможно. А что, если обратиться к оболочке CLR в коде, как показано ниже?
Button b = new Button();
b.Height = 10;
В таком случае, если блок 
set
 свойства 
Height
 содержит какой-то код помимо вызова 
SetValue()
, то он должен выполниться, потому что оптимизация синтаксического анализатора XAML в WPF не задействуется.
Запомните основное правило: при регистрации свойства зависимости используйте делегат 
ValidateValueCallback
 для указания на метод, который выполняет проверку достоверности данных. Такой подход гарантирует корректное поведение независимо от того, что именно применяется для получения/установки свойства зависимости — разметка XAML или код.
  
Построение специального свойства зависимости
 
Если к настоящему моменту вы слегка запутались, то такая реакция совершенно нормальна. Создание свойств зависимости может требовать некоторого времени на привыкание. Как бы то ни было, но это часть процесса построения многих специальных элементов управления WPF, так что давайте рассмотрим, каким образом создается свойство зависимости.
Начните с создания нового проекта приложения WPF по имени 
CustomDependencyProperty
. Выберите в меню Project (Проект) пункт Add User Control (WPF) (Добавить пользовательский элемент управления (WPF)) и создайте элемент управления с именем 
ShowNumberControl.xaml
.