병합된 리소스 사전

아티클
08/20/2008

업데이트: 2007년 11월

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 특성이 없습니다. 그러나 MergedDictionaries 컬렉션 내의 다른 ResourceDictionary 참조는 특별한 경우로 이 병합된 리소스 사전 시나리오에 사용하도록 예약되어 있습니다. 병합된 리소스 사전을 정의하는 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에 대한 자세한 내용은 Windows Presentation Foundation 응용 프로그램 리소스, 콘텐츠 및 데이터 파일을 참조하십시오.

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

병합된 사전 다시 사용

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

병합된 사전을 로컬 응용 프로그램 파일로 작성하거나 로컬 공유 저장소에 기록하는 것도 병합된 사전/응용 프로그램 배포의 사용 가능한 시나리오입니다.