ResourceDictionary.MergedDictionaries プロパティ

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>

プロパティ値

マージされたディクショナリのさまざまなリソース ディクショナリを構成する ResourceDictionary ディクショナリのリスト コレクション。

例

C++ または C# を使用するWindows アプリ SDK アプリの開始Microsoft Visual Studio テンプレートには、app.xaml ファイルにMergedDictionaries ノードが含まれています。 これは、いくつかの基本的なコントロール テンプレート定義を含むプロジェクト内の別の XAML ResourceDictionary を参照します。 コントロールの外観をカスタマイズするために、 ResourceDictionary 内で XAML を変更できます。

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

注釈

MergedDictionaries値を設定すると、ResourceDictionary XAML ファイルを複数のページ間で共有したり、複数のアプリ プロジェクトに追加できる共通ファイルとして共有したりできます。 これにより、開発と設計の観点からリソースに便利な因数分解と再利用の手法が提供されます。 通常は、XAML ファイルを コンテンツ 項目としてプロジェクトおよびアプリ マニフェストの一部として含めます。

MergedDictionaries XAML のキー付きリソースは、Application.Resources または FrameworkElement.Resources のプライマリ ResourceDictionary にあるキーと比較して一意である必要はありません。キーの検索順序は、最初にプライマリ ディクショナリで検索されます。 これにより、XAML ファイル内から取得したキー値 MergedDictionaries オーバーライドできる手法が可能になりますが、フォールバックとして、またはカスタマイズされていないリソースの一般的なセットとしてマージされたディクショナリを使用することもできます。

MergedDictionaries セット内でもフォールバック シーケンスを提供するために、MergedDictionaries セットに複数の ResourceDictionary を含めることができます。

MergedDictionariesとリソース参照シーケンスの使用方法の詳細については、「ResourceDictionary および XAML リソース参照」を参照してください。

ThemeDictionaries は、追加の XAML ResourceDictionary ソースをキー付きリソース セット全体にマージする関連プロパティです。このシナリオでは、コントロールにテーマ関連のリソースを提供します。

MergedDictionariesの ResourceDictionary 項目のコレクションの内容を変更することは一般的なシナリオではありません。 一般に、XAML でコレクションの内容を確立し、実行時に変更しません。 実行時コードでコレクション自体にアクセスするシナリオはあまりありません。 通常は、XAML 読み込み時に行われる組み込みのリソース参照に依存するか、マージされたリソースを含むキーでリソースを参照できる関連する Application.Resources または FrameworkElement.Resources コレクションに対してクエリを実行します。

こちらもご覧ください

• ResourceDictionary と XAML リソースの参照