ResourceDictionary.MergedDictionaries Property

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

Syntax


public IList<ResourceDictionary> MergedDictionaries { get; }


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

XAML Values

oneOrMoreResourceDictionaryElements

Ein oder mehrere explizite ResourceDictionary-Objektelemente. Jedes ResourceDictionary sollte einen Source-Wert als einziges Attribut angeben und sollte nicht versuchen, selbst einen schlüsselgebundenen untergeordneten Inhalt anzugeben. Geben Sie außerdem das x:Key-Attribut nicht für die ResourceDictionary-Objektelemente an.

Eigenschaftswert

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

Eine Auflistung von ResourceDictionary-Wörterbüchern, aus denen sich die verschiedenen Ressourcenwörterbücher in den zusammengeführten Wörterbüchern zusammensetzen.

Hinweise

Das Festlegen eines Werts MergedDictionaries ermöglicht Ihnen das Freigeben einer ResourceDictionary-XAML-Datei auf mehreren Seiten oder auch als gemeinsame Datei, die Sie möglicherweise mehreren App-Projekten hinzufügen. Aus Entwicklungs- und Entwurfssicht stellt dies eine nützliche Umgestaltungs- und Wiederverwendungstechnik für Ressourcen bereit. Sie enthalten die XAML-Datei in der Regel als Inhalt-Element als Teil des Projekts und des App-Manifests.

Die Ressourcen mit Schlüssel in einer MergedDictionaries XAML müssen verglichen mit den Schlüsseln, die im primären ResourceDictionary-Element für Application.Resources oder FrameworkElement.Resources gefunden werden, nicht eindeutig sein. Die Suchreihenfolge für Schlüssel sucht zudem zuerst im primären Wörterbuch. Dadurch können Sie sowohl jeden aus den MergedDictionaries-XAML-Dateien abgerufenen Schlüsselwert überschreiben als auch die zusammengeführten Wörterbücher als Fallback oder als einen allgemeinen Satz nicht-angepasster Ressourcen nutzen.

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

Weitere Informationen zur Nutzung von MergedDictionaries und der Ressourcenlookups-Sequenz finden Sie unter ResourceDictionary- und XAML--Ressourcenverweise.

ThemeDictionaries ist eine verwandte Eigenschaft, die auch zusätzliche XAML-ResourceDictionary-Quellen mit dem gesamten schlüsselgebundenen Ressourcensatz zusammenführt, in dem sich das Szenario für die Bereitstellung von Design-verknüpften Ressourcen für Steuerelemente befindet.

Es ist kein gängiges Szenarien, den Inhalt der Auflistung von ResourceDictionary-Elementen für MergedDictionaries zu ändern. Im Allgemeinen richten Sie den Auflistungsinhalt in XAML ein und ändern ihn nicht während der Laufzeit. Es gibt nur wenige Szenarien, bei denen Sie im Laufzeitcode auf die Auflistung selbst zugreifen können. Normalerweise können Sie sich auf die integrierte Ressourcensuche verlassen, die zur XAML-Ladezeit ausgeführt wird, 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.

Beispiele

Die beginnenden Microsoft Visual Studio-Vorlagen für eine Windows Store-App, die C++, C# oder Visual Basic verwendet, enthalten einen MergedDictionaries-Knoten in der app.xaml-Datei. Dies verweist eine separate XAML-ResourceDictionary im Projekt, das mehrere grundlegende Steuerelementvorlagendefinitionen enthält. Sie können den XAML-Code innerhalb der ResourceDictionary-Klasse ändern, um die Darstellung Ihrer Steuerelemente individuell anzupassen.


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

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

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

Metadaten

Windows.winmd

Siehe auch

ResourceDictionary
ResourceDictionary- und XAML-Ressourcenverweise

 

 

Anzeigen:
© 2014 Microsoft