ResourceDictionary.MergedDictionaries Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml

Возвращает коллекцию словарей ResourceDictionary , которые составляют различные словари ресурсов в объединенных словарях.

public:
 property IVector<ResourceDictionary ^> ^ MergedDictionaries { IVector<ResourceDictionary ^> ^ get(); };

IVector<ResourceDictionary> MergedDictionaries();

public IList<ResourceDictionary> MergedDictionaries { get; }

var iVector = resourceDictionary.mergedDictionaries;

Public ReadOnly Property MergedDictionaries As IList(Of ResourceDictionary)

<ResourceDictionary>
  <ResourceDictionary.MergedDictionaries>
    oneOrMoreResourceDictionaryElements
  </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

Значение свойства

IVector<ResourceDictionary>

IList<ResourceDictionary>

Коллекция списков словарей ResourceDictionary , которые составляют различные словари ресурсов в объединенных словарях.

Примеры

Начальные шаблоны Microsoft Visual Studio для приложения Windows App SDK на C++ или C# включают MergedDictionaries узел в файле app.xaml. Это ссылается на отдельный XAML ResourceDictionary в проекте, который содержит некоторые определения базовых шаблонов элементов управления. Вы можете изменить XAML в ResourceDictionary , чтобы настроить внешний вид элементов управления.

<Application
    ....
>
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="Common/StandardStyles.xaml"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

Комментарии

MergedDictionaries Задание значения позволяет совместно использовать XAML-файл ResourceDictionary на нескольких страницах или в качестве общего файла, который можно добавить в несколько проектов приложений. Это обеспечивает полезный метод факторинга и повторного использования ресурсов с точки зрения разработки и проектирования. Как правило, xaml-файл включается в качестве элемента Content в составе манифеста проекта и приложения.

Ресурсы с ключами в любом MergedDictionaries XAML не обязательно должны быть уникальными по сравнению с ключами, которые находятся в основном ResourceDictionary для Application.Resources или FrameworkElement.Resources, и порядок поиска ключей будет искаться в основном словаре. Это позволяет переопределить любое значение ключа, полученное из MergedDictionaries xaml-файлов, но объединенные словари также могут быть доступны в качестве резервного или общего набора ненастроенных ресурсов.

Вы можете включить в MergedDictionaries набор несколько ResourceDictionary, чтобы обеспечить резервную последовательность даже в пределах MergedDictionaries набора.

Дополнительные сведения об использовании MergedDictionaries и последовательности поиска ресурсов см. в статье Ссылки на ресурсы ResourceDictionary и XAML.

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

Изменение содержимого коллекции элементов ResourceDictionary для MergedDictionaries не является распространенным сценарием. Обычно содержимое коллекции устанавливается в XAML и не изменяется во время выполнения. Существует не так много сценариев, в которых можно получить доступ к самой коллекции в коде времени выполнения. Обычно вы полагаетесь на встроенный поиск ресурсов, выполняемый во время загрузки XAML, или запрашиваете соответствующие коллекции Application.Resources или FrameworkElement.Resources , которые могут ссылаться на ресурсы по ключу, включая объединенные ресурсы.

См. также раздел

• Ссылки на ресурсы ResourceDictionary и XAML