ResourceDictionary.MergedDictionaries プロパティ

定義

名前空間:

Microsoft.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# を使用する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セットに複数の ResourceDictionary をMergedDictionaries含めることができます。

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

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

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

こちらもご覧ください

• ResourceDictionary と XAML リソースの参照