병합된 리소스 사전

아티클
05/04/2023

WPF(Windows Presentation Foundation) 리소스에서는 병합된 리소스 사전 기능을 지원합니다. 이 기능을 사용하면 WPF 애플리케이션의 리소스 부분을 컴파일된 XAML 애플리케이션 외부에서 정의할 수 있습니다. 그런 다음 리소스를 애플리케이션 간에 공유하고 지역화를 위해 더욱 간편하게 격리할 수도 있습니다.

병합된 리소스 사전 도입

태그에서 다음 구문을 사용하여 병합된 리소스 사전을 페이지에 도입할 수 있습니다.

<Page.Resources>
  <ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
      <ResourceDictionary Source="myresourcedictionary.xaml"/>
      <ResourceDictionary Source="myresourcedictionary2.xaml"/>
    </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
</Page.Resources>

ResourceDictionary 요소에는 일반적으로 리소스 컬렉션의 모든 항목에 필요한 x:Key 지시문이 없습니다. 그러나 ResourceDictionary 컬렉션 내의 다른 MergedDictionaries 참조는 특별한 경우로 이 병합된 리소스 사전 시나리오에 사용하도록 예약되어 있습니다. 병합된 리소스 사전을 도입하는 ResourceDictionary에는 x:Key 지시문이 있을 수 없습니다. 일반적으로 MergedDictionaries 컬렉션 내의 각 ResourceDictionary는 Source 특성을 지정합니다. Source의 값은 병합할 리소스 파일의 위치를 확인하는 URI(Uniform Resource Identifier)여야 합니다. 해당 URI의 대상은 ResourceDictionary를 루트 요소로 갖는 다른 XAML 파일이어야 합니다.

참고

Source를 지정하는 대신 또는 지정한 원본에 포함된 리소스와 함께 병합된 사전으로 지정된 ResourceDictionary 내에 리소스를 정의할 수 있습니다. 그러나 이는 일반적인 시나리오가 아닙니다. 병합된 사전의 기본 시나리오는 외부 파일 위치에서 리소스를 병합하는 것입니다. 페이지의 태그 내에 리소스를 지정하려면 일반적으로 병합된 사전이 아니라 기본 ResourceDictionary에서 정의해야 합니다.

병합된 사전 동작

병합된 사전의 리소스는 리소스 조회 범위에서 이 사전이 병합된 주 리소스 사전의 범위 바로 뒤에 있는 위치에 있습니다. 개별 사전 내에서는 리소스 키가 고유해야 하지만 하나의 키가 병합된 사전 집합 내에서 여러 번 나올 수 있습니다. 이 경우 반환되는 리소스는 MergedDictionaries 컬렉션에서 순차적으로 찾은 마지막 사전에서 가져옵니다. MergedDictionaries 컬렉션을 XAML에서 정의한 경우 컬렉션에서 병합된 사전의 순서는 태그에서 제공한 요소의 순서가 됩니다. 키를 기본 사전에서 정의하고 병합된 사전에서도 정의하는 경우 반환되는 리소스는 기본 사전에서 가져옵니다. 이러한 범위 지정 규칙은 정적 리소스 참조와 동적 리소스 참조 모두에 동일하게 적용됩니다.

병합된 사전 및 코드

병합된 사전을 코드를 통해 Resources 사전에 추가할 수 있습니다. Resources 속성에 대해 존재하는 처음에는 비어 있는 기본 ResourceDictionary에서는 처음에는 비어 있는 기본 MergedDictionaries 컬렉션 속성이 있습니다. 코드를 통해 병합된 사전을 추가하려면 필요한 기본 ResourceDictionary에 대한 참조를 가져오고, 해당 MergedDictionaries 속성 값을 가져온 다음, MergedDictionaries에 포함된 일반 Collection에서 Add를 호출해야 합니다. 추가하는 개체는 새 ResourceDictionary여야 합니다. 코드에서 Source 속성을 설정하지 않습니다. 대신 ResourceDictionary 개체를 만들거나 로드하여 가져와야 합니다. 기존 ResourceDictionary를 로드하는 한 가지 방법은 ResourceDictionary 루트가 있는 기존 XAML 파일 스트림에서 XamlReader.Load를 호출한 다음, XamlReader.Load 반환 값을 ResourceDictionary에 캐스팅하는 것입니다.

병합된 리소스 사전 URI

사용할 URI(Uniform Resource Identifier) 형식으로 표시된 병합된 리소스 사전을 포함하기 위한 몇 가지 기술이 있습니다. 대체로 이러한 기술은 프로젝트의 일부로 컴파일된 리소스와 프로젝트의 일부로 컴파일되지 않은 리소스의 두 가지 범주로 나눌 수 있습니다.

프로젝트의 일부로 컴파일된 리소스의 경우 리소스 위치를 참조하는 상대 경로를 사용할 수 있습니다. 상대 경로는 컴파일하는 동안 평가됩니다. 리소스 빌드 작업을 통해 리소스를 프로젝트의 일부로 정의해야 합니다. 리소스 .xaml 파일을 프로젝트에 리소스로 포함하는 경우 리소스 파일을 출력 디렉터리로 복사할 필요가 없습니다. 리소스가 컴파일된 애플리케이션 내에 이미 포함되어 있습니다. 또한 콘텐츠 빌드 작업을 사용할 수도 있지만 이 경우 파일을 출력 디렉터리에 복사하는 것뿐만 아니라 실행 파일과의 동일한 경로 관계에 리소스 파일을 배포해야 합니다.

참고

포함 리소스 빌드 작업은 사용하지 않습니다. 이 빌드 작업 자체는 WPF 애플리케이션에서 지원되지만 Source의 확인에서 ResourceManager를 통합하지 않으므로 개별 리소스를 스트림에서 분리할 수 없습니다. ResourceManager를 사용하여 리소스에 액세스한 경우에는 포함 리소스를 다른 용도로는 계속 사용할 수 있습니다.

관련 기술로는 XAML 파일에 대한 Pack URI를 원본으로 참조하는 방법이 있습니다. Pack URI를 사용하면 참조된 어셈블리와 다른 기술의 구성 요소를 참조할 수 있습니다. Pack URI에 대한 자세한 내용은 WPF 애플리케이션 리소스, 콘텐츠 및 데이터 파일을 참조하세요.

프로젝트의 일부로 컴파일되지 않는 리소스의 경우 URI가 런타임에 평가됩니다. file: 또는 http:와 같은 일반 URI 전송을 사용하여 리소스 파일을 참조할 수 있습니다. 컴파일되지 않은 리소스 방법을 사용하는 경우 file: 액세스에 추가 배포 단계가 필요하고 http: 액세스에 인터넷 보안 영역이 수반된다는 단점이 있습니다.

병합된 사전 다시 사용

병합할 리소스 사전을 유효한 URI(Uniform Resource Identifier)를 통해 참조할 수 있으므로 병합된 리소스 사전을 여러 애플리케이션에서 공유하거나 다시 사용할 수 있습니다. 이렇게 하는 정확한 방법은 애플리케이션 배포 전략이나 사용하는 애플리케이션 모델에 따라 달라집니다. 앞서 설명한 Pack URI 전략에서는 배포하는 동안 어셈블리 참조를 공유하여 여러 프로젝트에서 병합된 리소스를 공통 소스로 지정할 수 있습니다. 이 시나리오에서는 리소스가 계속 클라이언트별로 배포되며 하나 이상의 애플리케이션에서 참조된 어셈블리를 배포해야 합니다. 또한 http 프로토콜을 사용하는 배포된 URI를 통해 병합된 리소스를 참조할 수도 있습니다.

병합된 사전을 로컬 애플리케이션 파일로 작성하거나 로컬 공유 스토리지에 기록하는 것도 병합된 사전/애플리케이션 배포의 사용 가능한 시나리오입니다.

지역화

지역화해야 하는 리소스를 기본 사전에 병합된 사전으로 격리하고 느슨한 XAML로 유지하는 경우 이러한 파일을 별도로 지역화할 수 있습니다. 이 기술은 위성 리소스 어셈블리를 지역화하는 것에 비해 간단합니다. 자세한 내용은 WPF 세계화 및 지역화 개요를 참조하세요.

다음을 통해 공유