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 鍵中的唯一，鍵的查詢順序會先在主字典中查詢。 這讓你能用一種技術，可以覆寫從 MergedDictionaries XAML 檔案中取得的任何鍵值，但你也可以將合併後的字典作為備用或作為一組通用的非自訂資源。

你可以在一個MergedDictionaries集合中包含多個 ResourceDictionary，以便在該MergedDictionaries集合內提供備用序列。

欲了解更多如何使用 MergedDictionaries 及資源查找序列的資訊，請參閱 ResourceDictionary 與 XAML 資源參考。

ThemeDictionaries 是一個相關屬性，也會將額外的 XAML ResourceDictionary 來源合併到整體的鍵控資源集中，該情境用於提供與主題相關的控制項資源。

更改 ResourceDictionaryMergedDictionaries 項目集合的內容並非常見情況。 通常你會在 XAML 中建立集合內容，執行時不會更改。 很少有情境能直接存取執行時程式碼中的集合。 通常你會依賴內建的 XAML 載入時的資源查詢，或者查詢相關的 Application.Resources 或 FrameworkElement.Resources 集合，這些集合可以依照鍵（包括合併後的資源）來參考資源。

另請參閱

• ResourceDictionary 與 XAML 資源參考