Ресурсы WPF

1. Ресурсы WPF • Два типа ресурсов WPF: • объектные ресурсы (object resource) – определенный .NET-объект, который можно использовать многократно; • ресурсы сборки ( assembly resource) – двоичные данные, встроенные в скомпилированную сборку.

2. Объектные ресурсы WPF • WPF ресурсы (объектные ресурсы) –простой способ повторного использования определенных объектов и их значений. Ресурсы можно создавать и использовать как в разметке, так и в коде. • Любой элемент, производный от FrameworkElementилиFrameworkContentElement, содержит коллекцию ResourceDictionary, которая доступна через свойствоResources. • public ResourceDictionary Resources { get; set; } • Класс ResourceDictionaryреализует интерфейсIDictionary, его внутренняя реализация использует класс Hashtable. Ресурсы хранятся в коллекции в виде пар ключ-значение. Обычноключ - это строка, но можно использовать и другие типы. • Каждый ресурс в коллекции ResourceDictionaryдолжен иметь уникальный ключ: • при определении ресурса в разметке уникальный ключ определяется через атрибут x:KeyAttribute; • при определении ресурса в коде ключ указывается как параметр метода Add. • Можно определить ресурсы в любом элементе. Дочерний элемент имеет доступ к любому ресурсу, определенному в любом из родительских элементов. По этой причине ресурсы обычно определяются в корневом элементе окна, страницы или приложения. • Свойство Resources возвращает только словарь ресурсов, объявленный непосредственно внутри данного элемента.

3. Примеропределения ресурса в разметке • В примере два контекстных меню объявлены как ресурсы в элементе Window - одно с ключом “key_Russian_Menu”, другое с ключом “key_English_Menu”. • Ресурс с ключом “key_Russian_Menu” используется как значение для свойства ContextMenuэлемента listBox1. <Window x:Class="Wpf_Resources.Window1" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="Window1" Height="394" Width="527" Loaded="Window_Loaded"> <Window.Resources> <ContextMenu x:Key="key_Russian_Menu"> <MenuItem Header="Добавить" Click="Add_Click"></MenuItem> <MenuItem Header="Добавить список" Click="Defaults_Click"></MenuItem> </ContextMenu> <ContextMenu x:Key="key_English_Menu"> <MenuItem Header="Add" Click="Add_Click"></MenuItem> <MenuItem Header="Add Defaults" Click="Defaults_Click"></MenuItem> </ContextMenu> </Window.Resources> <Grid Height="343"> <ListBox Margin="10,50,10,10" Name="listBox1" ContextMenu="{StaticResourcekey_Russian_Menu}"> </ListBox> </Grid> </Window>

4. Объект пользовательского типа как ресурс • В примере два объекта типа CustomData.Data_1 объявлены как ресурсы в объекте Application - один с ключом “datakey_1”, другой с ключом “datakey_2”. При создании объектов для их инициализации будут вызваны конструкторы без параметров. • Пространство имен CustomDataобъявлено в открывающем тэге элемента Applicationс префиксом zz. Префикс zzиспользуется в элементах разметки, объявляющих объекты типа Data_1. <Application x:Class="Wpf_Resources.App" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:zz="clr-namespace:Custom_Data" StartupUri="Window1.xaml"> <Application.Resources> <zz:Data_1 x:Key="datakey_1"> </zz:Data_1> <zz:Data_1 x:Key="datakey_2"> </zz:Data_1> </Application.Resources> </Application>

5. Работа с объектными ресурсами в коде • Класс FrameworkElementсодержит методы для поиска ресурса public Object FindResource( Object resourceKey ); public Object TryFindResource( Object resourceKey ); • Оба метода возвращают ссылку на ресурс с заданным ключом, если ключ найден. Если ресурс не найден, метод FindResource бросает исключение, а метод TryFindResourceвозвращает null. • В примере в обработчике English_Checked (события Checked радиокнопки) выполняется поиск ресурса с ключом “key_English_Menu”. Если ресурс найден и может быть приведен к типуContextMenu, он используется как значение свойства ContextMenuдля ListBox1. private void English_Checked(object sender, RoutedEventArgs e) { ContextMenu menu = listBox1.TryFindResource("key_English_Menu") as ContextMenu; if (menu != null) listBox1.ContextMenu = menu; }

6. Статические и динамические ресурсы WPF • После того, как ресурс определен, на него можно ссылаться как в разметке, так и в коде. • Ресурс можно использовать как статический или динамический. В разметке определены расширения StaticResourceили DynamicResource. • При обработке StaticResourceпросматриваются доступные словари ресурсов. Это происходит в процессе загрузки, в тот момент, когда свойству необходимо присвоить значение из статических ресурсов. • При обработке DynamicResourceключ создает выражение, которое вычисляется только в процессе выполнения приложения, и тогда на его основе формируется значение. • Синтаксический анализ ресурсов выполняется асинхронно. Ресурс, определенный в XAML , может быть не доступен даже в обработчике события Loaded для элемента, в котором он определен. • Доступ к ресурсам из кода эквивалентен ссылке DynamicResource в XAML.

7. Cтатические ресурсы WPF • В поисках необходимого ключа для статического ресурса словари ресурсов просматриваются в следующем порядке: • словарь, определенный в элементе, для которого устанавливается свойство; • словари логического дерева элементов в направлении к родительскому элементу вплоть до корневого элемента; • словарь объекта Application. • Словари просматриваются в процессе загрузки, в тот момент, когда свойству необходимо присвоить значение из статических ресурсов. • Опережающие ссылки (forward reference) не поддерживаются статическими ресурсами. Внутри самого словаря ресурсов ссылку можно сделать только на ранее определенный ресурс.

8. Использование статических ресурсов WPF • Статические ресурсы рекомендуется использовать в следующих случаях: • Значение ресурса не изменяется после того, как на него была сделана ссылка в первый раз. • Дизайн приложения концентрирует большую часть своих ресурсов в словарях уровня страниц или приложения и ссылки на ресурсы не вычисляются на основе поведения времени выполнения, например, призагрузке страниц. • Статический ресурс можно использовать, чтобы присвоить значение свойству, которое не является свойством зависимостей. • Можно создать словарь ресурсов искомпилировать его в DLL для повторного использования. • Ресурс используется для того, чтобы установить большое число свойств зависимостей. Свойства зависимостей имеют поддержку для эффективного кэширования, и в случае, когда значение свойства зависимости можно вычислить при загрузке, использование статических ресурсов повышает эффективность приложения.

9. Использование динамических ресурсов WPF • В следующих случаях используются динамические ресурсы: • Значение зависит от параметров, которые станут известны только в период выполнения, например, есть ссылки на значения SystemColors, SystemFonts илиSystemParameters. • Словарь ресурсов изменяется во время работы приложения. • Ресурсы имеет внутренние связи, использующие опережающие ссылки (forward reference), которые не поддерживаются статическими ресурсами. • Используется большой ресурс, который может быть запрошен не сразу после загрузки. В отличие от статических ресурсов, динамические ресурсы не загружаются до тех пор, пока не будут использованы. • Создается стиль (style), в которомустанавливаются значения , зависящие от других установок пользователя. • Ресурс используется элементом, для которого в процессе жизни приложения может быть заменен родительский элемент, что возможно изменяет область поиска ресурса.