ResourceDictionary.MergedDictionaries Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient une collection des dictionnaires ResourceDictionary qui constituent les différents dictionnaires de ressources dans les dictionnaires fusionnés.

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>

Valeur de propriété

IVector<ResourceDictionary>

IList<ResourceDictionary>

Collection de listes des dictionnaires ResourceDictionary qui constituent les différents dictionnaires de ressources dans les dictionnaires fusionnés.

Exemples

Les modèles Microsoft Visual Studio de démarrage pour une application UWP en C++, C# ou Visual Basic incluent un nœud MergedDictionaries dans le fichier app.xaml. Cela fait référence à un ResourceDictionary XAML distinct dans le projet qui contient des définitions de modèle de contrôle de base. Vous pouvez modifier le CODE XAML dans ResourceDictionary afin de personnaliser l’apparence de vos contrôles.

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

Remarques

La définition d’une valeur MergedDictionaries vous permet de partager un fichier XAML ResourceDictionary entre plusieurs pages, ou également en tant que fichier commun que vous pouvez ajouter à plusieurs projets d’application. Cela fournit une technique de factorisation et de réutilisation utile pour les ressources du point de vue du développement et de la conception. Vous incluez généralement le fichier XAML en tant qu’élément Content dans le cadre du manifeste du projet et de l’application.

Les ressources à clé dans n’importe quel XAML MergedDictionaries n’ont pas besoin d’être uniques par rapport aux clés telles qu’elles se trouvent dans le ResourceDictionary principal pour Application.Resources ou FrameworkElement.Resources, et l’ordre de recherche des clés s’affiche d’abord dans le dictionnaire principal. Cela permet d’utiliser une technique permettant de remplacer n’importe quelle valeur de clé obtenue à partir des fichiers XAML MergedDictionaries, mais vous pouvez également avoir les dictionnaires fusionnés disponibles en tant que secours ou en tant qu’ensemble général de ressources non personnalisées.

Vous pouvez inclure plusieurs ResourceDictionary dans un jeu MergedDictionaries afin de fournir une séquence de secours même dans le jeu MergedDictionaries.

Pour plus d’informations sur l’utilisation de MergedDictionaries et de la séquence de recherche de ressources, consultez ResourceDictionary et références de ressources XAML.

ThemeDictionaries est une propriété associée qui fusionne également d’autres sources XAML ResourceDictionary dans l’ensemble global de ressources à clé, où le scénario vise à fournir des ressources liées au thème pour les contrôles.

La modification du contenu de la collection d’éléments ResourceDictionary pour MergedDictionaries n’est pas un scénario courant. En règle générale, vous établissez le contenu de la collection en XAML et ne le modifiez pas au moment de l’exécution. Il n’existe pas beaucoup de scénarios dans lesquels vous accédiez à la collection elle-même dans le code d’exécution. En règle générale, vous vous appuyez sur la recherche de ressources intégrée qui se produit au moment du chargement XAML, ou vous interrogez les collections Application.Resources ou FrameworkElement.Resources appropriées qui peuvent référencer des ressources par clé, y compris les ressources fusionnées.

Voir aussi

• Références aux ressources ResourceDictionary et XAML