ResourceDictionary.MergedDictionaries Eigenschaft

Definition

Namespace:

Microsoft.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 Microsoft Visual Studio-Startvorlagen für eine Windows App SDK-App mit C++ oder C# 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 XAML-Code MergedDictionaries müssen nicht eindeutig im Vergleich zu den Schlüsseln sein, die im primären ResourceDictionary für Application.Resources oder FrameworkElement.Resources zu finden sind, 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-Dateien in eine MergedDictionaries Gruppe einschließen, um eine Fallbacksequenz auch innerhalb der MergedDictionaries Gruppe bereitzustellen.

Weitere Informationen zur Verwendung MergedDictionaries und zur 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