ResourceDictionary.MergedDictionaries Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft eine Auflistung der ResourceDictionary-Wörterbücher ab, die die verschiedenen Ressourcenwörterbücher in den zusammengeführten Wörterbüchern bilden.

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

IVector<ResourceDictionary>

IList<ResourceDictionary>

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

Beispiele

Die Startvorlagen von Microsoft Visual Studio für eine UWP-App mit C++, C# oder Visual Basic enthalten einen MergedDictionaries-Knoten in der Datei app.xaml. Dies verweist auf ein separates XAML ResourceDictionary im Projekt, das einige grundlegende Steuerelementvorlagendefinitionen enthält. Sie können den XAML-Code innerhalb von 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 auf mehreren Seiten oder auch als gemeinsame Datei freigeben, die Sie mehreren App-Projekten hinzufügen können. Dies bietet eine nützliche Factoring- und Wiederverwendungsmethode für Ressourcen aus Entwicklungs- und Entwurfssicht. In der Regel schließen Sie die XAML-Datei als Inhaltselement als Teil des Projekt- und App-Manifests ein.

Die schlüsselierten Ressourcen in einem MergedDictionaries-XAML müssen im Vergleich zu den Schlüsseln, die im primären ResourceDictionary für Application.Resources oder FrameworkElement.Resources zu finden sind, nicht eindeutig sein, und die Nachschlagereihenfolge nach Schlüsseln sucht zuerst im primären Wörterbuch. Dies ermöglicht eine Technik, bei der Sie jeden Schlüsselwert überschreiben können, der aus MergedDictionaries-XAML-Dateien abgerufen wird, aber Sie können auch die zusammengeführten Wörterbücher als Fallback oder als allgemeine Gruppe nicht angepasster Ressourcen zur Verfügung stellen.

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

Weitere Informationen zur Verwendung von 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 gesamten Schlüsselressourcensatz zusammenführt, wobei das Szenario designbezogene Ressourcen für Steuerelemente bereitstellt.

Das Ändern des Inhalts der Auflistung von ResourceDictionary-Elementen für MergedDictionaries ist kein häufiges Szenario. Im Allgemeinen richten Sie den Sammlungsinhalt in XAML ein und ändern ihn 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-Sammlungen ab, die nach Schlüssel auf Ressourcen verweisen können, einschließlich der zusammengeführten Ressourcen.

Weitere Informationen

• ResourceDictionary- und XAML-Ressourcenreferenzen