ResourceDictionary.MergedDictionaries プロパティ

定義

名前空間:

Windows.UI.Xaml

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

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>

プロパティ値

IVector<ResourceDictionary>

IList<ResourceDictionary>

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

例

C++、C#、または Visual Basic を使用する UWP アプリ用の 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 に見られるキーと比較して一意である必要はありません。キーの参照順序は、最初にプライマリ ディクショナリで検索されます。 これにより、MergedDictionaries XAML ファイル内から取得したキー値をオーバーライドできる手法が可能になりますが、マージされたディクショナリをフォールバックとして、またはカスタマイズされていないリソースの一般的なセットとして使用することもできます。

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

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

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

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

こちらもご覧ください

• ResourceDictionary と XAML リソースの参照