Чтение онлайн

ЖАНРЫ

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

Несмотря на то что часть реализации свойства зависимости предусматривает определение оболочки 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
.

На заметку! Более подробные сведения о классе

UserControl
в WPF ищите в главе 27, а пока просто следуйте указаниям по мере проработки примера.

Подобно окну типы

UserControl
в WPF имеют файл XAML и связанный файл кода. Модифицируйте разметку XAML пользовательского элемента управления, чтобы определить простой элемент
Label
внутри
Grid
:

<UserControl x:Class="CustomDepProp.ShowNumberControl"

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

xmlns:local="clr-namespace: CustomDependencyProperty"

mc:Ignorable="d"

d:DesignHeight="300" d:DesignWidth="300">

<Grid>

<Label x:Name="numberDisplay" Height="50" Width="200"

Background="LightBlue"/>

</Grid>

</UserControl>

В файле кода для данного элемента создайте обычное свойство .NET Core, которое упаковывает поле типа

int
и устанавливает новое значение для свойства
Content
элемента
Label
:

public partial class ShowNumberControl : UserControl

{

public ShowNumberControl

{

InitializeComponent;

}

// Обычное свойство .NET Core.

private int _currNumber = 0;

public int CurrentNumber

{

get => _currNumber;

set

{

_currNumber = value;

numberDisplay.Content = CurrentNumber.ToString;

}

}

}

Обновите определение XAML в

MainWindow.xml
, объявив экземпляр специального элемента управления внутри диспетчера компоновки
StackPanel
. Поскольку специальный элемент управления не входит в состав основных сборок WPF, понадобится определить специальное пространство имен XML, которое отображается на него. Вот требуемая разметка:

<Window x:Class="CustomDepPropApp.MainWindow"

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

xmlns:myCtrls="clr-namespace: CustomDependencyProperty"

xmlns:local="clr-namespace: CustomDependencyProperty"

mc:Ignorable="d"

Title="Simple Dependency Property App" Height="450" Width="450"

Поделиться с друзьями: