Ресурсы wpf

Ресурсы WPFРесурсы WPF

Два типа ресурсов WPF:

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

•  ресурсы сборки ( assembly resource) – двоичные данные, встроенные в скомпилированную сборку.

Объектные ресурсы WPFОбъектные ресурсы WPF

Класс ResourceDictionary реализует интерфейс IDictionary, его внутренняя реализация использует класс Hashtable. Ресурсы хранятся в коллекции в виде пар ключ-значение. Обычно ключ - это строка, но можно использовать и другие типы.

Каждый ресурс в коллекции ResourceDictionary должен иметь уникальный ключ:

• при определении ресурса в разметке уникальный ключ определяется через атрибут x:KeyAttribute;

• при определении ресурса в коде ключ указывается как параметр метода Add.

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

Свойство Resources возвращает только словарь ресурсов, объявленный непосредственно внутри данного элемента.

public ResourceDictionary Resources { get; set; }

WPF ресурсы (объектные ресурсы) – простой способ повторного использования определенных объектов и их значений. Ресурсы можно создавать и использовать как в разметке, так и в коде.

Любой элемент, производный от FrameworkElement или FrameworkContentElement, содержит коллекцию ResourceDictionary, которая доступна через свойство Resources.

Пример определения ресурса в разметкеПример определения ресурса в разметке В примере два контекстных меню объявлены как ресурсы в элементе 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="{StaticResource key_Russian_Menu}">

</ListBox>

</Grid>

</Window>

Объект пользовательского типа как ресурсОбъект пользовательского типа как ресурс

В примере два объекта типа 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>

Работа с объектными ресурсами в кодеРабота с объектными ресурсами в коде Класс 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;

}

Статические и динамические ресурсы WPFСтатические и динамические ресурсы WPF

После того, как ресурс определен, на него можно ссылаться как в разметке, так и в коде.

Ресурс можно использовать как статический или динамический. В разметке определены расширения StaticResource или DynamicResource.

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

При обработке DynamicResource ключ создает выражение, которое вычисляется только в процессе выполнения приложения, и тогда на его основе формируется значение.

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

Доступ к ресурсам из кода эквивалентен ссылке DynamicResource в XAML.

Cтатические ресурсы WPFCтатические ресурсы WPF

В поисках необходимого ключа для статического ресурса словари ресурсов просматриваются в следующем порядке:

• словарь, определенный в элементе, для которого устанавливается свойство;

• словари логического дерева элементов в направлении к родительскому элементу вплоть до корневого элемента;

• словарь объекта Application.

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

Опережающие ссылки (forward reference) не поддерживаются статическими ресурсами. Внутри самого словаря ресурсов ссылку можно сделать только на ранее определенный ресурс.

Использование статических ресурсов WPFИспользование статических ресурсов WPF

Статические ресурсы рекомендуется использовать в следующих случаях:

• Значение ресурса не изменяется после того, как на него была сделана ссылка в первый раз.

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

• Статический ресурс можно использовать, чтобы присвоить значение свойству, которое не является свойством зависимостей.

• Можно создать словарь ресурсов и скомпилировать его в DLL для повторного использования.

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

Использование динамических ресурсов WPFИспользование динамических ресурсов WPF

В следующих случаях используются динамические ресурсы:

• Значение зависит от параметров, которые станут известны только в период выполнения, например, есть ссылки на значения SystemColors, SystemFonts или SystemParameters.

• Словарь ресурсов изменяется во время работы приложения.

• Ресурсы имеет внутренние связи, использующие опережающие ссылки (forward reference), которые не поддерживаются статическими ресурсами.

• Используется большой ресурс, который может быть запрошен не сразу после загрузки. В отличие от статических ресурсов, динамические ресурсы не загружаются до тех пор, пока не будут использованы.

• Создается стиль (style), в котором устанавливаются значения , зависящие от других установок пользователя.

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