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 App 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 가져온 키 값을 재정의할 수 있지만 병합된 사전을 대체 또는 일반 사용자 지정되지 않은 리소스 집합으로 사용할 수도 있습니다.

집합 내에서도 대체 시퀀스를 제공하기 위해 집합에 둘 이상의 ResourceDictionaryMergedDictionaries 를 MergedDictionaries 포함할 수 있습니다.

사용 MergedDictionaries 방법 및 리소스 조회 시퀀스에 대한 자세한 내용은 ResourceDictionary 및 XAML 리소스 참조를 참조하세요.

ThemeDictionaries 는 추가 XAML ResourceDictionary 원본을 전체 키 리소스 집합에 병합하는 관련 속성입니다. 여기서 시나리오는 컨트롤에 대한 테마 관련 리소스를 제공하는 것입니다.

에 대한 MergedDictionariesResourceDictionary 항목 컬렉션의 내용을 변경하는 것은 일반적인 시나리오가 아닙니다. 일반적으로 XAML에서 컬렉션 콘텐츠를 설정하고 런타임에 변경하지 않습니다. 런타임 코드에서 컬렉션 자체에 액세스하는 시나리오는 많지 않습니다. 일반적으로 XAML 로드 시간에 발생하는 기본 제공 리소스 조회를 사용하거나 병합된 리소스를 포함하여 키별로 리소스를 참조할 수 있는 관련 Application.Resources 또는 FrameworkElement.Resources 컬렉션을 쿼리합니다.

추가 정보

• ResourceDictionary 및 XAML 리소스 참조