ResourceDictionary.MergedDictionaries Propriété

Définition

Espace de noms:

Microsoft.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 SDK d'application Windows en C++ ou C# incluent un MergedDictionaries nœud 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 MergedDictionaries valeur 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 MergedDictionaries XAML n’ont pas besoin d’être uniques par rapport aux clés telles que trouvées dans le ResourceDictionary principal pour Application.Resources ou FrameworkElement.Resources, et l’ordre de recherche des clés est d’abord observé dans le dictionnaire principal. Cela permet d’utiliser une technique qui vous permet de remplacer n’importe quelle valeur de clé obtenue à MergedDictionaries partir de fichiers XAML, 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 MergedDictionaries ensemble afin de fournir une séquence de secours même dans l’ensemble MergedDictionaries .

Pour plus d’informations sur l’utilisation MergedDictionaries et la séquence de recherche de ressources, consultez Références de ressources ResourceDictionary et 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