MergedDictionaries, propriété

ResourceDictionary.MergedDictionaries Property

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

Syntaxe


public IList<ResourceDictionary> MergedDictionaries { get; }


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

XAML Values

oneOrMoreResourceDictionaryElements

Un ou plusieurs éléments objet ResourceDictionary explicites. Chacun de ces ResourceDictionary doit spécifier une valeur Source comme son seul attribut, et ne doit pas essayer de spécifier lui-même tout contenu enfant à clé. En outre, ne spécifiez pas l'attribut x:Key sur les éléments objets ResourceDictionary.

Valeur de propriété

Type: IVector<ResourceDictionary> [C++] | System.Collections.Generic.IList<ResourceDictionary> [.NET]

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

Remarques

La définition d'une valeur MergedDictionaries vous permet de partager un fichier XAML ResourceDictionary parmi plusieurs pages, ou également sous forme d'un fichier commun que vous pouvez ajouter à plusieurs projets d'application. Cela fournit une technique de factorisation et de réutilisation utile pour les ressources sur le plan du développement et de la conception. Vous incluez généralement le fichier XAML comme élément de Contenu dans le cadre du manifeste du projet et de l'application.

Il n'est pas nécessaire que les ressources indexées dans une propriété MergedDictionaries XAML soient uniques par rapport aux clés telles qu'elles se trouvent dans le ResourceDictionary principal pour Application.Resources ou FrameworkElement.Resources, et les clés commenceront par être recherchées dans le dictionnaire principal. Cela autorise une technique qui vous permet de substituer toute valeur de clé obtenue à partir des fichiers XAML MergedDictionaries, mais les dictionnaires fusionnés peuvent aussi être disponibles sous forme de rappel ou d'ensemble général de ressources non personnalisées.

Vous pouvez inclure plusieurs ResourceDictionary dans un ensemble de MergedDictionaries pour fournir une séquence de secours même dans l'ensemble de MergedDictionaries.

Pour plus d'informations sur le mode d'utilisation de MergedDictionaries et sur la séquence de recherche de la ressource , consultez Références ResourceDictionary et StaticResource.

ThemeDictionaries est une propriété connexe qui fusionne également les autres sources ResourceDictionary XAML en jeu de clés de ressources globales, où le scénario consiste à fournir des ressources liées au thème pour les contrôles.

Modifier le contenu de la collection d'éléments ResourceDictionary pour MergedDictionaries n'est pas un scénario courant. En général, vous générez le contenu de la collection en XAML et vous ne le modifiez pas au moment de l'exécution. Il 'y a peu de scénarios où vous accédez à la collection elle-même dans le code d'exécution. En général, vous utilisez la recherche intégrée de ressources qui se produit au moment du chargement XAML ou vous interrogez les collections appropriées Application.Resources ou FrameworkElement.Resources qui peuvent référencer les ressources par clé, y compris les ressources fusionnées.

Exemples

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


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

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

ResourceDictionary
Références ResourceDictionary et StaticResource

 

 

Afficher:
© 2017 Microsoft