Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю

После запуска приложения объект анимации не сможет найти подходящую цель и сгенерируется исключение. Причина в том, что свойство 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 во втором. Модифицируйте код следующим образом:

<b>// Обратите внимание на второй параметр конструктора UIPropertyMetadata.</b>

public static readonly DependencyProperty CurrentNumberProperty =

  DependencyProperty.Register(&quot;CurrentNumber&quot;, typeof(int),

    typeof(ShowNumberControl),

  new UIPropertyMetadata(100,

  new PropertyChangedCallback(CurrentNumberChanged)),

  new ValidateValueCallback(ValidateCurrentNumber));

Конечной целью внутри метода CurrentNumberChamged() будет изменение свойства Content объекта Label на новое значение, присвоенное свойству CurrentNumber. Однако возникает серьезная проблема:метод CurrentNumberChanged() является статическим, т.к. он должен работать со статическим объектом DependencyProperty. Как тогда получить доступ к объекту Label для текущего экземпляра ShowNumberControl? Нужная ссылка содержится в первом параметре DependencyObject. Новое значение можно найти с применением входных аргументов события. Ниже показан необходимый код, который будет изменять свойство Content объекта Label:

private static void CurrentNumberChanged(DependencyObject depObj,   

DependencyPropertyChangedEventArgs args)

{

<b>  // Привести DependencyObject к ShowNumberControl.</b>

  ShowNumberControl c = (ShowNumberControl)depObj;

<b>  // Получить элемент управления Label в ShowNumberControl.</b>

  Label theLabel = c.numberDisplay;

<b>  // Установить для Label новое значение.</b>