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 範本包含 MergedDictionaries app.xaml 檔案中的節點。 這會參考專案中包含一些基本控制項範本定義的個別 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 資源參考