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

  WindowStartupLocation="CenterScreen">
   <StackPanel>
   <myCtrls:ShowNumberControl
   HorizontalAlignment="Left" x:Name="myShowNumberCtrl"
   CurrentNumber="100"/>
   </StackPanel>
 </Window>

Похоже, что визуальный конструктор Visual Studio корректно отображает значение, установленное в свойстве CurrentNumber (рис. 25.23).

Однако что, если к свойству CurrentNumber необходимо применить объект анимации, который обеспечит изменение значения свойства от 100 до 200 в течение 10 секунд? Если это желательно сделать в разметке, тогда область myCtrls:ShowNumberControl можно изменить следующим образом:

 <myCtrls:ShowNumberControl x:Name="myShowNumberCtrl" CurrentNumber="100">
  <myCtrls:ShowNumberControl.Triggers>
  <EventTrigger RoutedEvent = "myCtrls:ShowNumberControl.Loaded">
  <EventTrigger.Actions>
  <BeginStoryboard>
  <Storyboard TargetProperty = "CurrentNumber">
  <Int32Animation From = "100" To = "200" Duration = "0:0:10"/>
  </Storyboard>
  </BeginStoryboard>
  </EventTrigger.Actions>
  </EventTrigger>
  </myCtrls:ShowNumberControl.Triggers>
 </myCtrls:ShowNumberControl>

После запуска приложения объект анимации не сможет найти подходящую цель и сгенерируется исключение. Причина в том, что свойство CurrentNumber не было зарегистрировано как свойство зависимости! Чтобы устранить проблему, возвратитесь в файл кода для специального элемента управления и полностью закомментируйте текущую логику свойства (включая закрытое поддерживающее поле).

Теперь добавьте показанный ниже код, чтобы свойство CurrentNumber создавалось как свойство зависимости:

 public int CurrentNumber
 {
  get => (int)GetValue(CurrentNumberProperty);
  set => SetValue(CurrentNumberProperty, value);
 }

 public static readonly DependencyProperty CurrentNumberProperty =
  DependencyProperty.Register("CurrentNumber",
  typeof(int),
  typeof(ShowNumberControl),
  new UIPropertyMetadata(0));

Работа похожа на ту, что делалась в реализации свойства Height: тем не менее, предыдущий фрагмент кода регистрирует свойство непосредственно в теле, а не в статическом конструкторе (что хорошо). Также обратите внимание, что объект UIPropertyMetadata используется для определения стандартного целочисленного значения (0) вместо более сложного объекта FrameworkPropertyMetadata. В итоге получается простейшая версия CurrentNumber как свойства зависимости.

Добавление процедуры проверки достоверности данных

Хотя у вас есть свойство зависимости по имени CurrentNumber (и исключение больше не генерируется), анимация пока еще не наблюдается. Следующей корректировкой будет указание функции, вызываемой для выполнения проверки достоверности данных. В данном примере предполагается, что нужно обеспечить нахождение значения свойства CurrentNumber в диапазоне между 0 и 500.

Добавьте в метод DependencyProperty.Register последний аргумент типа ValidateValueCallback, указывающий на метод по имени ValidateCurrentNumber.

Здесь ValidateValueCallback является делегатом, который может указывать только на методы, возвращающие тип bool и принимающие единственный аргумент типа object. Экземпляр object представляет присваиваемое новое значение. Реализация ValidateCurrentNumber должна возвращать true, если входное значение находится в ожидаемом диапазоне, и false в противном случае:

 public static readonly DependencyProperty CurrentNumberProperty =
  DependencyProperty.Register("CurrentNumber",
  typeof(int),
  typeof(ShowNumberControl),
  new UIPropertyMetadata(100),
  new ValidateValueCallback(ValidateCurrentNumber));

 // Простое бизнес-правило: значение должно находиться
 // в диапазоне между 0 и 500.
 public static bool ValidateCurrentNumber(object value) =>
  Convert.ToInt32(value) >= 0 && Convert.ToInt32(value) <= 500;

Реагирование на изменение свойства

Итак, допустимое число уже есть, но анимация по-прежнему отсутствует. Последнее изменение, которое потребуется внести — передать во втором аргументе конструктора UIPropertyMrtadata объект PropertyChangedCallback. Данный делегат может указывать на любой метод, принимающий DependencyObject в первом параметре и DependencyPropertyChangeEventArgs во втором. Модифицируйте код следующим образом:

  // Обратите внимание на второй параметр конструктора UIPropertyMetadata.
 public static readonly DependencyProperty CurrentNumberProperty =
  DependencyProperty.Register("CurrentNumber", typeof(int),
  typeof(ShowNumberControl),
  new UIPropertyMetadata(100,
  new PropertyChangedCallback(CurrentNumberChanged)),
  new ValidateValueCallback(ValidateCurrentNumber));