ResourceDictionary.MergedDictionaries Eigenschaft

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>

Eigenschaftswert

Eine Listensammlung der ResourceDictionary-Wörterbücher , die die verschiedenen Ressourcenwörterbücher in den zusammengeführten Wörterbüchern bilden.

Beispiele

Die Start-Microsoft Visual Studio Vorlagen für eine Windows App SDK-App mit C++ oder C# enthalten einen MergedDictionaries Knoten in der Datei "app.xaml". Dadurch wird auf ein separates XAML ResourceDictionary im Projekt verwiesen, das einige grundlegende Steuerelementvorlagendefinitionen enthält. Sie können den XAML-Code im ResourceDictionary ändern, um die Darstellung Ihrer Steuerelemente anzupassen.

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

Hinweise

Wenn Sie einen MergedDictionaries Wert festlegen, können Sie eine ResourceDictionary-XAML-Datei unter mehreren Seiten oder auch als allgemeine Datei freigeben, die Sie möglicherweise mehreren App-Projekten hinzufügen. Dies bietet eine nützliche Faktor- und Wiederverwendungstechnik für Ressourcen aus entwicklungs- und entwurfsbezogener Sicht. In der Regel fügen Sie die XAML-Datei als Inhaltselement als Teil des Projekts und des App-Manifests ein.

Die schlüsselierten Ressourcen in MergedDictionaries XAML müssen nicht eindeutig sein, im Vergleich zu den Schlüsseln, die im primären ResourceDictionary für Application.Resources oder FrameworkElement.Resources zu finden sind, und die Nachschlagereihenfolge für Schlüssel sucht zuerst im primären Wörterbuch. Dies ermöglicht eine Technik, mit der Sie alle in MergedDictionaries XAML-Dateien abgerufenen Schlüsselwerte außer Kraft setzen können. Sie können jedoch auch die zusammengeführten Wörterbücher als Fallback oder als allgemeine Gruppe nicht angepasster Ressourcen verfügbar haben.

Sie können mehr als ein ResourceDictionary in einen MergedDictionaries Satz einschließen, um eine Fallbacksequenz auch innerhalb des MergedDictionaries Satzes bereitzustellen.

Weitere Informationen zur Verwendung MergedDictionaries und der Ressourcensuchsequenz finden Sie unter ResourceDictionary- und XAML-Ressourcenverweise.

ThemeDictionaries ist eine verwandte Eigenschaft, die auch zusätzliche XAML ResourceDictionary-Quellen in den gesamtschlüsselierten Ressourcensatz zusammenführt, in dem das Szenario für die Bereitstellung von designbezogenen Ressourcen für Steuerelemente dient.

Das Ändern des Inhalts der Auflistung von ResourceDictionary-ElementenMergedDictionaries ist kein häufiges Szenario. Im Allgemeinen richten Sie den Sammlungsinhalt in XAML ein und ändern sie nicht zur Laufzeit. Es gibt nicht viele Szenarien, in denen Sie im Laufzeitcode auf die Sammlung selbst zugreifen würden. In der Regel verlassen Sie sich auf die integrierte Ressourcensuche, die zur XAML-Ladezeit erfolgt, oder Sie fragen die relevanten Application.Resources - oder FrameworkElement.Resources-Auflistungen ab, die nach Schlüssel auf Ressourcen verweisen können, einschließlich der zusammengeführten Ressourcen.

Weitere Informationen

• ResourceDictionary- und XAML-Ressourcenreferenzen