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

Троелсен Эндрю

На этом текущий пример завершен. В последующих главах вы увидите в действии другие элементы управления, но к настоящему моменту вы должны чувствовать себя увереннее с процессом построения пользовательских интерфейсов в Visual Studio, а также при работе с разметкой XAML и кодом С#.

Роль свойств зависимости

Подобно любому API-интерфейсу .NET Core внутри WPF используется каждый член системы типов .NET Core (классы, структуры, интерфейсы, делегаты, перечисления) и каждый член типа (свойства, методы, события, константные данные, поля только для чтения и т.д.). Однако в WPF также поддерживается уникальная программная концепция под

названием свойство зависимости.

Как и "нормальное" свойство .NET Core (которое в литературе, посвященной WPF, часто называют свойством CLR), свойство зависимости можно устанавливать декларативно с помощью разметки XAML или программно в файле кода. Кроме того, свойства зависимости (подобно свойствам CLR) в конечном итоге предназначены для инкапсуляции полей данных класса и могут быть сконфигурированы как доступные только для чтения, только для записи или для чтения и записи.

Вы будете практически всегда пребывать в блаженном неведении относительно того, что фактически устанавливаете (или читаете) свойство зависимости, а не свойство CLR! Например, свойства

Height

и

Width

, которые элементы управления WPF наследуют от класса

FrameworkElement

, а также член

Content

, унаследованный от класса

ControlContent

, на самом деле являются свойствами зависимости:

<!-- Установить три свойства зависимости -->

<Button x:Name = "btnMyButton" Height = "50" Width = "100" Content = "OK"/>

С учетом всех указанных сходств возникает вопрос: зачем нужно было определять в 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("Value")

};

// Указать свойство зависимости.

this.labelSBThumb.SetBinding(Label.ContentProperty, b);

}

Вы увидите похожий код в главе 27 во время исследования запуска анимации в коде:

// Указать свойство зависимости.

rt.BeginAnimation(RotateTransform.AngleProperty, dblAnim);

Потребность в построении специального свойства зависимости возникает только во время разработки собственного элемента управления WPF. Например, когда создается класс

UserControl

с четырьмя специальными свойствами, которые должны тесно интегрироваться с API-интерфейсом WPF, они должны быть реализованы с применением логики свойств зависимости.

В частности, если нужно, чтобы свойство было целью операции привязки данных или анимации, если оно обязано уведомлять о своем изменении, если свойство должно быть в состоянии работать в качестве установщика в стиле WPF или получать свои значения от родительского элемента, то возможностей обычного свойства CLR окажется не достаточно. В случае использования обычного свойства другие программисты действительно могут получать и устанавливать его значение, но если они попытаются применить такое свойство внутри контекста службы WPF, то оно не будет работать ожидаемым образом. Поскольку заранее нельзя узнать, как другие пожелают взаимодействовать со свойствами специальных классов

UserControl

, нужно выработать в себе привычку при построении специальных элементов управления всегда определять свойства зависимости.